jpmschweitzerandClaude
8eec3b68d6
One agent doc per repo, and it is CLAUDE.md. This repo carried two -- one at the root and one under webber-api/ -- which is the drift problem in its purest form: two documents, one subject, and no way to know which the last reader trusted. Written fresh rather than reformatted. README.md linked to webber-api/AGENTS.md, so that pointer moves with the file rather than dangling. The architecture section states the method used to establish what is live -- import the app inside the container and read sys.modules -- and then the case where that method fails here. src/domains/tools is absent from a cold snapshot and is entirely live: each agent's _register_tools imports its tool package from inside the method body, on every /agents/run. Absence from a snapshot taken before any request is served is a timing artifact, not evidence of death, and deleting on that basis would have removed the tool layer. Co-Authored-By: Claude <noreply@anthropic.com>
3.3 KiB
3.3 KiB
Webber - Multi-Agent AI Development System
A Claude Code-inspired development assistant powered by local LLMs via Ollama.
Features
- 3 Agents - Explore (read-only), Plan (architecture), Task (orchestrator)
- 8 Tools - File read/write/edit, glob, grep, bash, web search
- Conversations - Multi-turn memory with context summarization
- Streaming - Real-time response display
- Self-hosted - Runs on your own hardware with Ollama
Structure
This is a monorepo containing three subprojects:
| Directory | Description |
|---|---|
webber-api/ |
FastAPI backend server with agent orchestration |
webber-cli/ |
Command-line client for interacting with the API |
webber-sandbox/ |
Test project for functional testing |
Additional Directories
| Directory | Description |
|---|---|
sandbox-templates/ |
Reusable project templates for the sandbox |
.gitea/workflows/ |
CI/CD workflows for releases |
Quick Start
1. Start the API Server
cd webber-api
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt -r requirements-dev.txt
./wakeup.sh
2. Set Up the CLI
cd webber-cli
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pip install -e .
# Test connection
webber-cli status
3. Explore with Webber
# One-shot exploration
webber-cli explore "find all bugs in the code" -d /path/to/project
# Interactive chat
webber-cli chat -d /path/to/project
Available Tools
| Tool | Description |
|---|---|
read_file |
Read file contents with line numbers |
glob_files |
Find files by pattern |
grep_content |
Search file contents with regex |
bash_readonly |
Safe bash commands (ls, git status, etc.) |
edit_file |
Find-and-replace editing |
write_file |
Create/overwrite files |
bash |
Full bash with safety controls |
web_search |
Search web via SearXNG |
Agents
| Agent | Purpose | Tools |
|---|---|---|
| Explore | Fast codebase navigation, search | Read-only (glob, grep, read, bash_readonly) |
| Plan | Design implementation strategies | Read-only (same as Explore) |
| Task | Autonomous multi-step execution | All tools + spawn_agent |
API Endpoints
# Stateless agent execution
POST /agents/run # Execute agent, get response
POST /agents/stream # Execute with SSE streaming
GET /agents/ # List available agents
# Stateful conversations (multi-turn memory)
POST /conversations/ # Create conversation
GET /conversations/ # List conversations
POST /conversations/{id}/messages # Add message, get agent response
Versioning
This project uses prefixed tags for independent release cycles:
api/v0.4.0- Triggers API Docker build and deploymentcli/v0.1.0- Triggers CLI installer build (future)
Requirements
- Python 3.12+
- Ollama running with
gemma4:e2bmodel - Docker (for production deployment)
- SearXNG (optional, for web search)
Documentation
CLAUDE.md- Agent development guidelines (repo-wide)webber-api/docs/COVERAGE.md- Feature coverage and roadmapwebber-api/docs/architecture.md- System architecturewebber-cli/README.md- CLI usage guide
License
MIT