craft-code 0.1.0__tar.gz

craft_code-0.1.0/.env.example

@@ -0,0 +1,20 @@
+# --- Anthropic (direct) ---
+ANTHROPIC_API_KEY=your-key-here
+
+# --- OpenRouter (alternative — install with: uv pip install -e ".[openrouter]") ---
+# OPENROUTER_API_KEY=sk-or-v1-your-key-here
+
+# --- Model selection ---
+# Main agent model. Use provider:model format.
+# Anthropic direct:   anthropic:claude-sonnet-4-6
+# OpenRouter:         openrouter:anthropic/claude-sonnet-4-6
+#                     openrouter:google/gemini-2.5-flash
+#                     openrouter:deepseek/deepseek-r1
+# MODEL=anthropic:claude-sonnet-4-6
+
+# Subagent model (code-reviewer, researcher). Defaults to MODEL if unset.
+# Use a cheaper model here to save credits.
+# SUBAGENT_MODEL=openrouter:google/gemini-2.5-flash
+
+# --- Project settings ---
+# PROJECT_ROOT=.

craft_code-0.1.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,44 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize, ready_for_review, reopened]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'
+          plugins: 'code-review@claude-code-plugins'
+          prompt: '/code-review:code-review ${{ github.repository }}/pull/${{ github.event.pull_request.number }}'
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+

craft_code-0.1.0/.github/workflows/claude.yml

@@ -0,0 +1,50 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://code.claude.com/docs/en/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'
+

craft_code-0.1.0/.gitignore

@@ -0,0 +1,168 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+# .python-version
+
+# pipenv
+#Pipfile.lock
+
+# UV
+#uv.lock
+
+# poetry
+#poetry.lock
+#poetry.toml
+
+# pdm
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#pixi.lock
+.pixi
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Claude Code
+.claude/

craft_code-0.1.0/AGENTS.md

@@ -0,0 +1,35 @@
+# Project: Deep Coding Agent
+
+## Overview
+A Claude Code-like AI coding assistant built with LangChain Deep Agents.
+
+## Tech Stack
+- Python 3.11+
+- LangChain Deep Agents framework
+- LangGraph for orchestration
+- Rich for terminal UI
+
+## Project Structure
+```
+code_craft/
+  __init__.py       — package metadata
+  agent.py          — core agent factory (build_agent)
+  cli.py            — interactive CLI entry point
+  config.py         — AgentConfig dataclass
+  interrupt_handler.py — human-in-the-loop approval UI
+  prompts.py        — system prompts for agent and subagents
+  tools.py          — custom tools (git, delete, test runner)
+skills/
+  testing/SKILL.md
+  code_review/SKILL.md
+```
+
+## Commands
+- Run: `code-craft` or `python -m code_craft.cli`
+- Test: `pytest`
+- Lint: `ruff check .`
+
+## Conventions
+- Use type hints on public functions
+- Keep modules focused — one responsibility per file
+- Use Rich for all terminal output

craft_code-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shubham Agarwal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

craft_code-0.1.0/PKG-INFO

@@ -0,0 +1,121 @@
+Metadata-Version: 2.4
+Name: craft-code
+Version: 0.1.0
+Summary: A Claude Code-like AI coding assistant built with LangChain Deep Agents
+Project-URL: Homepage, https://github.com/shubhamagarwal/code-craft
+Project-URL: Repository, https://github.com/shubhamagarwal/code-craft
+Project-URL: Bug Tracker, https://github.com/shubhamagarwal/code-craft/issues
+Author: Shubham Agarwal
+License: MIT
+License-File: LICENSE
+Keywords: agent,ai,claude,coding-assistant,langchain,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.11
+Requires-Dist: deepagents>=0.4.0
+Requires-Dist: langchain-anthropic>=0.3.0
+Requires-Dist: langchain-openrouter>=0.1.0
+Requires-Dist: langgraph-checkpoint>=2.0.0
+Requires-Dist: langgraph>=0.3.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: rich>=13.0.0
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: openrouter
+Requires-Dist: langchain-openrouter>=0.1.0; extra == 'openrouter'
+Provides-Extra: sandbox
+Requires-Dist: langchain-daytona>=0.1.0; extra == 'sandbox'
+Description-Content-Type: text/markdown
+
+# Code Craft
+
+A Claude Code-like AI coding assistant built with [LangChain Deep Agents](https://docs.langchain.com/oss/python/deepagents/overview).
+
+## 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
+
+```bash
+# 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
+
+```bash
+# 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
+
+```python
+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
+```

craft_code-0.1.0/README.md

@@ -0,0 +1,80 @@
+# Code Craft
+
+A Claude Code-like AI coding assistant built with [LangChain Deep Agents](https://docs.langchain.com/oss/python/deepagents/overview).
+
+## 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
+
+```bash
+# 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
+
+```bash
+# 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
+
+```python
+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
+```

craft_code-0.1.0/code_craft/AGENTS.md

@@ -0,0 +1,35 @@
+# Project: Code Craft
+
+## Overview
+A Claude Code-like AI coding assistant built with LangChain Deep Agents.
+
+## Tech Stack
+- Python 3.11+
+- LangChain Deep Agents framework
+- LangGraph for orchestration
+- Rich for terminal UI
+
+## Project Structure
+```
+code_craft/
+  __init__.py       — package metadata
+  agent.py          — core agent factory (build_agent)
+  cli.py            — interactive CLI entry point
+  config.py         — AgentConfig dataclass
+  interrupt_handler.py — human-in-the-loop approval UI
+  prompts.py        — system prompts for agent and subagents
+  tools.py          — custom tools (git, delete, test runner)
+skills/
+  testing/SKILL.md
+  code_review/SKILL.md
+```
+
+## Commands
+- Run: `code-craft` or `python -m code_craft.cli`
+- Test: `pytest`
+- Lint: `ruff check .`
+
+## Conventions
+- Use type hints on public functions
+- Keep modules focused — one responsibility per file
+- Use Rich for all terminal output

craft_code-0.1.0/code_craft/__init__.py

@@ -0,0 +1,3 @@
+"""Deep Coding Agent — A Claude Code-like AI coding assistant built with Deep Agents."""
+
+__version__ = "0.1.0"

craft_code-0.1.0/code_craft/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running with: python -m code_craft"""
+
+from .cli import main
+
+main()