induscode

A terminal-first AI coding agent for your shell. A full coding assistant — read/write/edit files, run commands, search the codebase, mount MCP servers, branch and resume sessions — in a streaming Textual terminal UI. Built on the indusagi framework.

pip install induscode

That's it — induscode pulls in the indusagi framework (with the mcp and tui extras) automatically. Requires Python 3.11+.

Quick start

Set your provider API key, then run it:

export ANTHROPIC_API_KEY=sk-ant-...        # or OPENAI_API_KEY, GOOGLE_API_KEY, …
pindus                                     # launch the interactive console

The package installs two console scripts — pindus (primary) and induscode (alias). They're identical; use whichever you like.

pindus                                  # interactive Textual console
pindus -p "explain this repo"           # one-shot: print the answer and exit
pindus -p --json "explain this repo"    # headless NDJSON line protocol (for hosts)
pindus -m claude-haiku-4-5 -p "hi"      # pick a model
pindus --list-models                    # browse the provider/model catalog
pindus signin                           # store credentials (OAuth or API key)
pindus signin --list                    # show stored accounts
pindus --help                           # full flag table (@file attachments, --, …)

In the console

• Streaming markdown answers, structured diffs, and collapsible tool cards (Ctrl-O to expand)
• Slash commands — /model, /settings, /theme, /resume, /branch, /timeline, /export, /keys, /help, and ~20 more
• !command to run a shell command inline
• Esc aborts a running turn; Ctrl-C exits
• A footer with live token / cost / context-window % for the active model
• Twelve dialogs: model picker, scoped models, settings, theme (live preview), session browser, branch tree, login, and more
• Branchable session history — resume a prior session, fork from any turn

Configuration

• API keys come from the standard provider env vars (ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY, …), or run pindus signin for OAuth.
• State (sessions, settings, credentials) lives under ~/.pindusagi/. Override with INDUSAGI_CODING_AGENT_DIR or INDUSAGI_HOME.
• Per-project settings: <cwd>/.pindusagi/settings.json.
• MCP servers: mount external tool servers with repeatable --mcp <server>.
• Project context: AGENTS.md / CLAUDE.md in the working directory are picked up automatically.

What it can do

A complete coding-agent tool suite: read / write / edit files, run shell commands and background processes, grep and find across the tree, fetch web pages and search, a todo planner, MCP-mounted remote tools, and Composio SaaS connectors. Works with 849 models across 24 providers via the indusagi catalog.

Development

# install the framework editable first, then the agent
pip install -e ../indusagi-python-rebuild
pip install -e ".[dev]"
pytest            # 703 tests; network-free (mock connector, Textual Pilot)

License

AGPL-3.0-only. See LICENSE, NOTICE and CREDITS.md.