Skip to main content

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.

Metadata

Release files for induscode 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for induscode 0.1.6
File Size Uploaded Provenance Actions
induscode-0.1.6.tar.gz 719.0 kB Without provenance Details for induscode-0.1.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for induscode 0.1.6
File Interpreter ABI Platform Actions
induscode-0.1.6-py3-none-any.whl Python 3 none any Details for induscode-0.1.6-py3-none-any.whl

Total release size: 1.4 MB

Release files / induscode-0.1.6.tar.gz

Download URL induscode-0.1.6.tar.gz
Size 719.0 kB
Tags Source
SHA-256 checksum
How to use checksums
e0914d8c45818dcf03ca909e5792364ccd57bf125c589c02760d4d2849350cba
BLAKE2b-256 checksum
How to use checksums
985dbcb9f799e23b0c79980dd2704c73878309183bf2c1072054ead65e858952
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.13

Release files / induscode-0.1.6-py3-none-any.whl

Download URL induscode-0.1.6-py3-none-any.whl
Size 644.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a4922f774d7964f5e172f1c760c53d686f7acf82a24aad39762e9dd5d62e81a7
BLAKE2b-256 checksum
How to use checksums
c1387e05b609faf9cebfbb153e651b433131f181e9148acdecfc56adb635ba91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.13

Security for induscode 0.1.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page