icod 0.1.0

icod.ai — Python coding agent powered by Claude (pip launcher; downloads the native binary on first run)

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.