Coders AI Assistant

March 7, 2025 · View on GitHub

Coders is an AI-powered terminal user interface (TUI) tool that helps you edit code with any LLM on OpenRouter.

Features

  • Interactive TUI Interface: Fully navigable terminal interface with keyboard shortcuts
  • Model Selection: Choose between Claude, Gemini, or any OpenRouter model
  • Cost Tracking: Monitor your OpenRouter credit usage directly in the app
  • File Browser: Easily navigate and select files to modify
  • Multi-File Context: Select multiple files to provide better context for AI prompts
  • Side-by-Side Diff View: Compare original and modified code before accepting changes
  • Explanation Panel: View AI explanations for each code change
  • Context Window Tracking: Track the total prompt size and progress of the context window

Coders AI Assistant

Getting Started

  1. Clone the repository: git clone https://github.com/0xKoda/coders.git && cd coders
  2. Launch the application with cargo run
  3. On first run, you'll be prompted to enter your OpenRouter API key
  4. Navigate the file browser to select a file to modify
  5. Press the appropriate key to perform actions (as shown in the command bar)

The application has several modes, each with its own set of controls:

Global Controls

  • h: Access help screen from most modes

Welcome Screen

  • Enter: Continue to configuration or file browser
  • q: Quit the application

Configuration Screen

  • ↑/↓: Navigate between available models
  • Enter: Select model and proceed
  • Ctrl+A: Set API key

File Browser

  • ↑/↓: Navigate between files
  • Enter: Open selected file
  • m: Switch to multi-file selection mode
  • c: View credits information
  • q: Quit the application
  • s: Select File

Multi-File Selection

  • ↑/↓: Navigate between files
  • Space: Toggle selection of current file
  • Enter: Confirm selection and proceed to prompt
  • Esc: Return to file browser

Editor View

  • ↑/↓: Scroll through file content
  • p: Enter prompt mode to modify the file
  • q: Return to file browser

Prompt Input

  • Type your request for code modifications
  • Enter: Submit prompt
  • Esc: Cancel and return to previous screen

Results View

  • Tab: Switch between original and modified code panels
  • e: Toggle explanation panel
  • y: Accept changes and apply them
  • n: Reject changes and return to editor
  • q: Return to file browser without applying changes
  • ←/→: Navigate between files when viewing multi-file diffs
  • ↑/↓: Scroll Files

Credits Screen

  • q: Return to previous screen

Commands and Workflow

  1. Select a File: Navigate the file browser and press Enter to open a file
  2. Provide Context (Optional): Press m to enter multi-file selection, choose additional files with Space, then confirm with Enter
  3. Modify Code: With a file open, press p to enter a prompt describing the changes you want
  4. Review Changes: In the diff view, examine the proposed changes and explanation
  5. Apply Changes: Press y to accept changes or n to reject them
  6. Continue Iterating: Make additional changes or select different files

Cost Monitoring

Press c in the file browser to view your OpenRouter credits information:

  • Total credits available
  • Total usage so far
  • Last updated time

Model Selection

By default, the application uses Claude 3.7 Sonnet. To select a different model:

  1. Start the application
  2. In the configuration screen, use ↑/↓ to select a model
  3. Select "custom" to enter any OpenRouter model ID

API Key Management

Your OpenRouter API key is securely stored in your system's configuration directory:

  • To change your API key, press Ctrl+A in the configuration screen
  • Enter your new API key and press Enter

Note

Make sure you have a valid OpenRouter API key. The application will prompt you to enter it if it's not already saved.