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 !commandto 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 runpindus signinfor OAuth. - State (sessions, settings, credentials) lives under
~/.pindusagi/. Override withINDUSAGI_CODING_AGENT_DIRorINDUSAGI_HOME. - Per-project settings:
<cwd>/.pindusagi/settings.json. - MCP servers: mount external tool servers with repeatable
--mcp <server>. - Project context:
AGENTS.md/CLAUDE.mdin 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.