Interactive Mode
Running codity with no arguments launches the interactive terminal UI (TUI). This provides a menu-driven interface to all CLI features without memorizing commands.
Launching
codity
Home Screen
The interactive UI displays:
- Repository info: Current repo name and active branch
- Git status: Number of changed files
- Auth status: Logged-in user and organization
- Suggestions: Context-aware command recommendations based on your current git state
Menu Sections
The main menu is organized into the following sections:
Getting Started: Login, logout, and repository initialization.
Code Review: Run reviews on staged changes, all uncommitted changes, a specific commit, or a branch diff.
Security Scan: Scan staged changes, all changes, a specific commit, or a branch diff for vulnerabilities.
Debug: Generate structured debug prompts for LLM agents.
Command Smith: Convert natural language into shell commands.
Integrations: List and resolve PR/MR comments.
Context and Config: Generate, view, or update project context. Manage CLI configuration, reset settings, and run health checks.
Navigation
| Key | Action |
|---|---|
Up / Down (or j / k) |
Move cursor |
| Enter / Right | Select item or drill into submenu |
| Esc / Left | Go back to parent menu |
q / Ctrl+C |
Quit |
Some menu items prompt for additional input (commit SHA, branch name, etc.) directly within the TUI.
infoThe interactive UI is the fastest way to explore what the CLI can do. Every action available in the TUI maps directly to a CLI command you can run non-interactively.
