Code Agent

Sofia Billger Bergström 2025-11-10

A lightweight, LLM‑driven assistant that can scaffold projects, edit files, generate documentation, and operate as an interactive chatbot.

Quick start

# Install dependencies (uv is recommended)
uv venv .venv
source .venv/bin/activate
uv pip install -e .

# Run the interactive agent
code-agent

You can now type queries, e.g.:

> Show me a simple project scaffold
> Add a new function to utils.py

Architecture

flowchart LR
  CLI(Typer CLI) --\u003e Main(Main driver)
  Main --\u003e Graph(LangGraph)
  Graph --\u003e Tools
  Graph --\u003e Memory(Chroma vector store)
  Main --\u003e LLM(LLM wrapper)

Loading

For a deeper dive, see the following sections:

• CODE_AGENT – Core components and internals.
• USAGE – Detailed usage patterns.
• FILES – File‑level overview of the repo.
• FAQ & Troubleshooting – Common questions and solutions.
• CONTRIBUTING – Guidelines for contributing to the project.
• LICENSE – Project licensing information.
• ROADMAP – Future plans and development.
• CHANGELOG – Version history and changes.
• Agent Workflow