codrninja 1.2.6

Terminal coding assistant with TypeScript TUI — multi-provider, session-based

🥷 codrninja

A terminal coding assistant with a TypeScript TUI — powered by the AI provider of your choice.

Providers

Provider	Setup	Notes
claude-cli	Claude Code installed	Uses your Claude Code subscription — no API key needed
OpenAI	OAuth or API key	gpt-4o, gpt-5, codex models
Anthropic	OAuth or API key	claude-sonnet, claude-opus
Ollama	Local server	Any local model
OpenRouter	API key	Access to all major models

Install

pip3 install codrninja

Then start the TUI:

codrninja

The server starts automatically in the background. On first run, configure your provider via /provider.

TypeScript TUI (recommended)

codrninja uses a TypeScript TUI built with Ink. On first launch it looks for the TUI at ~/codrninja-tui. If not found it falls back to the built-in Textual TUI.

To use the full TUI, clone it next to your home directory:

git clone https://github.com/20ZollCoder/codrninja-tui ~/codrninja-tui
cd ~/codrninja-tui && npm install

Quick Start

# Install
pip3 install codrninja

# Start
codrninja

# Inside the TUI — configure a provider:
/provider

# Select claude-cli to use your Claude Code subscription (no API key needed)
# Or select openai / anthropic and authenticate via OAuth or API key

TUI Slash Commands

Command	Description
/provider	Switch or configure AI provider
/model	Change model for this session
/exec <cmd>	Run a shell command
/search <query>	Web search
/fetch <url>	Fetch a web page
/commit <msg>	Git add -A and commit
/diff	Show current git diff
/test	Run tests
/build <task>	Run build agent
/plan <task>	Run plan agent
/clear	Clear the conversation
/undo	Remove the last message pair
/session	Show session info
/status	Show provider / model status
/help	Show all commands
/exit	Quit

Sessions

codrninja organises work into named sessions. Each session has its own conversation history and can have its own model and provider.

# Open a specific session directly
codrninja my-project

# Or use the CODRNINJA_SESSION env var
CODRNINJA_SESSION=my-project codrninja

Configuration

Provider and model settings are stored in ~/.config/codrninja/config.json and can be changed at any time from within the TUI via /provider and /model.

The server runs on port 7384 by default. Override with:

codrninja serve --port 8000
CODRNINJA_SERVER=http://127.0.0.1:8000 codrninja

Links

• GitHub: https://github.com/20ZollCoder/codrninja
• Issues: https://github.com/20ZollCoder/codrninja/issues

License

MIT