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.

Test Generation — Generate tests for staged changes, all changes, a specific commit, or a branch diff.

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.