Metadata-Version: 2.4
Name: icod
Version: 0.1.0
Summary: icod.ai — Python coding agent powered by Claude (pip launcher; downloads the native binary on first run)
Author: icod.ai team
License: Proprietary
License-File: LICENSE
Keywords: ai,claude,cli,coding-agent
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# icod

icod.ai — a Python coding agent powered by Claude.

This pip package is a **thin launcher** for the icod CLI. On first run it
downloads the platform-native icod binary, caches it locally, and re-executes
that binary for every subsequent invocation.

## Install

```
pip install icod
```

## First run

The first time you run any `icod` command, the launcher will download the
native binary (~500 MB) into `~/.icod/bin/`. Subsequent runs are instant.

```
icod login            # save your Anthropic API key
icod chat "hello"     # one-shot chat with the agent
icod run              # interactive REPL
icod --help           # see all commands
```

## Supported platforms

- Windows x64

Other platforms will fail at first run with a clear error. macOS and Linux
support is planned.

## Configuration

| Environment variable | Purpose |
|---|---|
| `ICOD_BINARY_URL`   | Override the base URL the launcher downloads from |
| `ICOD_BINARY_PATH`  | Skip the download entirely and use an existing local binary |
| `ICOD_BINARY_VERSION` | Pin to a specific binary version (defaults to this package's version) |
| `ANTHROPIC_API_KEY` | Anthropic API key (alternative to `icod login`) |

## Storage

- Native binary cache: `~/.icod/bin/<version>/icod.exe`
- Anthropic API key: `~/.icod/credentials` (created by `icod login`)
- Per-workspace session storage: SQLite under `.icod/` in each workspace

## Source code

The launcher in this package is open. The icod runtime itself is distributed
as a pre-compiled native binary. For build-from-source access, contact the
icod.ai team.
