Metadata-Version: 2.4
Name: induscode
Version: 0.1.2
Summary: Indusagi coding agent — terminal-first AI coding agent on the indusagi framework (Python rebuild)
Project-URL: Homepage, https://github.com/varunisrani/indusagi-ts
Project-URL: Repository, https://github.com/varunisrani/indusagi-ts
Project-URL: Issues, https://github.com/varunisrani/indusagi-ts/issues
Author: Varun Israni
Author-email: IndusAGI Team <team@indusagi.ai>
License-Expression: MIT
License-File: CREDITS.md
License-File: NOTICE
Keywords: agent,ai,cli,coding-agent,llm,mcp,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Code Generators
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: indusagi[mcp,tui]>=0.1.2
Requires-Dist: markdown-it-py>=3.0
Requires-Dist: pygments>=2.18
Requires-Dist: python-ulid>=2.7
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Description-Content-Type: text/markdown

# 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`](https://pypi.org/project/indusagi/) framework.

```bash
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:

```bash
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.

```bash
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

```bash
# 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

MIT. See [NOTICE](NOTICE) and [CREDITS.md](CREDITS.md).
