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.0.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.0-py3-none-any.whl (17.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: craft_code-0.1.0.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.0.tar.gz
Algorithm Hash digest
SHA256 fccf03aa2fa2df3e4f076e4ca679b781f9b9936554e1ee7a666874356230a806
MD5 5e5ade458c629422f5330359da79ae56
BLAKE2b-256 8bdeb206b12966c52eeb8e3c940c8c260a1e23c1943428b48ed0a5824ddd8097

See more details on using hashes here.

File details

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

File metadata

  • Download URL: craft_code-0.1.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8ecfb3dee614beab0cb3c7c0e208b9fcb4a460972cc56f0458f70ffbf04b74ea
MD5 a603d807eb60026fc28f20c7b6c863d9
BLAKE2b-256 94625ece28276e432a64519e6e8343d05b3420d5477f0d49f4bc09c38eabe88a

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