Skip to main content

A Claude Code-like AI coding assistant built with LangChain Deep Agents

Project description

Code Craft

A Claude Code-like AI coding assistant built with LangChain Deep Agents.

Features

  • File system access — reads, writes, and edits project files
  • Shell execution — runs commands (tests, linters, build tools)
  • Agentic planning — breaks tasks into steps with write_todos
  • Human-in-the-loop — asks approval before destructive operations
  • Persistent memory — remembers project context across sessions
  • Subagent delegation — spawns code-reviewer and researcher subagents
  • Skill system — lazy-loaded workflows for testing, code review, etc.

Quick Start

# 1. Clone and install
cd code-craft
uv venv && source .venv/bin/activate
uv pip install -e .

# 2. Set your API key
cp .env.example .env
# Edit .env and add your ANTHROPIC_API_KEY

# 3. Run
coding-agent

Usage

# Interactive CLI
coding-agent

# Or run directly
python -m code_craft

Inside the CLI:

  • Type your coding request
  • The agent will ask for approval before file writes and shell commands
  • Use /new to start a fresh thread, /quit to exit

Programmatic Usage

from code_craft.agent import build_agent
from code_craft.config import AgentConfig

config = AgentConfig(project_root="/path/to/your/project")
agent, checkpointer, store = build_agent(config)

Configuration

Set these in .env or as environment variables:

Variable Default Description
ANTHROPIC_API_KEY (required) Your Anthropic API key
MODEL anthropic:claude-sonnet-4-6 Model to use
PROJECT_ROOT . Root directory for file operations

Architecture

code_craft/
  agent.py              — Agent factory with backends, subagents, skills
  cli.py                — Interactive Rich-powered CLI
  config.py             — AgentConfig dataclass
  interrupt_handler.py  — Human-in-the-loop approval UI
  prompts.py            — System prompts
  tools.py              — Custom tools (git, delete, tests)
skills/
  testing/SKILL.md      — Test writing workflow
  code_review/SKILL.md  — Code review workflow
AGENTS.md               — Project context for the agent

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

craft_code-0.1.1.tar.gz (15.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

craft_code-0.1.1-py3-none-any.whl (17.8 kB view details)

Uploaded Python 3

File details

Details for the file craft_code-0.1.1.tar.gz.

File metadata

  • Download URL: craft_code-0.1.1.tar.gz
  • Upload date:
  • Size: 15.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.0

File hashes

Hashes for craft_code-0.1.1.tar.gz
Algorithm Hash digest
SHA256 18a67c919c1aef55b772de02858999a1488c3b523794a9ed5565cf4593f1bb7a
MD5 2bcf20ddcd2aef1036daf2b5ee0d412c
BLAKE2b-256 e8870eee85aba5dc83fe46d247116a0d032a1c5d3a8cf26297ff5c169983bdfc

See more details on using hashes here.

File details

Details for the file craft_code-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: craft_code-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 17.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.0

File hashes

Hashes for craft_code-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 90136c5dbb707fa3d5dfc761031372f98c9a6c3a15b2d59d74910ca92e11e202
MD5 05f28743bc5e5272dfa7c07536315366
BLAKE2b-256 dd1b026ba541cbb40348f43decb17d7c129513e7cac9cfcacb415da6b104eb43

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page