English | 中文

KittyChain - Terminal agent for onchain analysis

KittyChain is a lightweight terminal AI agent focused on practical onchain investigation workflows. It combines a compact interactive CLI with built-in tools for wallet inspection, token analysis, web lookup, local file operations, and skill-based task guidance, so you can move from a question to an actionable chain analysis session in one place.

Get Started

1. Install KittyChain:

pip install kittychain

2. Start the guided configuration flow:

kittychain --config

3. Launch the interactive terminal UI:

kittychain

For coding work, start the coding-focused toolset:

kittychain --code

Features And Onchain Capabilities

• Lightweight terminal agent loop with an interactive REPL and one-shot prompt mode.
• Support for OpenAI-compatible and Anthropic-compatible model interfaces.
• Built-in local tools for shell execution, file reading and editing, web search, web fetching with LLM summaries, TODO tracking, and skill loading.
• Slash-command driven workflow for switching models, saving sessions, compacting context, and browsing loaded skills.
• Session persistence and interruption support for longer investigative workflows.

KittyChain also includes built-in onchain analysis tools for common investigation tasks:

• Address balance lookup
• Address identity and label lookup
• Address transfer inspection
• Malicious address screening
• Token info lookup
• Token security checks

This makes KittyChain a practical fit for wallet triage, token due diligence, suspicious-address checks, and general blockchain research directly from the terminal.

Usage

Run the interactive terminal UI:

kittychain

Run the coding-focused mode:

kittychain --code

Run a one-shot prompt and exit:

kittychain -p "Check this wallet and summarize the risk signals"

Resume a saved session:

kittychain -r session_1234567890

Open the configuration wizard:

kittychain --config

You can also start KittyChain with the module entry point:

python -m kittychain

When the CLI is busy, press Esc to interrupt the current run at the next safe checkpoint.

Startup Modes

• kittychain or kittychain --chain: load the default on-chain investigation toolset.
• kittychain --code: load the coding-focused toolset for software engineering tasks.

Interactive Commands

Inside the REPL, KittyChain supports:

• /help
• /reset
• /skills
• /<skill name>
• /model <name>
• /tokens
• /compact
• /save
• /sessions
• /quit

The /skills command shows the skills loaded at startup. Slash commands also support prefix matching while typing, making it easier to discover available commands and skills from the terminal.