lobs-server

Central backend for Lobs Mission Control. FastAPI + SQLite REST API with built-in task orchestrator.

Features

• Task & Project Management — Full CRUD with kanban workflow, tiered approvals
• Memory System — Second brain: daily notes, long-term memory, search, quick capture
• Topics/Knowledge — Research workspaces with documents and auto-created topics
• Chat — Real-time WebSocket messaging with OpenClaw agent bridge
• Orchestrator — Automatic server-side task routing (explicit agent -> capability registry -> fallback), worker spawning, model routing with fallback chains, failure escalation
• Calendar Integration — Events, recurring schedules, tracker deadline sync
• System Health — Activity timeline, cost tracking, monitoring
• Auth — Bearer token authentication on all endpoints

Setup

Quick start: See QUICKSTART.md for detailed setup instructions.

git clone git@github.com:RafeSymonds/lobs-server.git
cd lobs-server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Generate an API token
python bin/generate_token.py my-token

# Run
./bin/run  # or: uvicorn app.main:app --host 0.0.0.0 --port 8000

Documentation

• QUICKSTART.md — Get up and running in 5 minutes
• ARCHITECTURE.md — System architecture, data flow, key components
• AGENTS.md — Complete API reference and development guide
• CHANGELOG.md — API changes and version history
• CONTRIBUTING.md — Development guide for contributors and AI agents
• docs/ — Implementation guides, design documents, investigations
  • Testing Guide — How to run and write tests
  • Known Issues — Technical debt and known problems
  • Topics Implementation — Knowledge organization system
  • Document Lifecycle — Document state management
  • See docs/README.md for full index

API

All endpoints at /api/* require Bearer token (except /api/health).

See AGENTS.md for complete endpoint reference.

Testing

source .venv/bin/activate
python -m pytest -v

See Also

Lobs Ecosystem Documentation (in ~/self-improvement/docs/):

• LOBS_ECOSYSTEM.md — Cross-project architecture and feature matrix
• GETTING_STARTED.md — 20-30 min ecosystem onboarding
• TECH_STACK_REFERENCE.md — Technology choices and patterns
• Code Quality System — Handoffs, reviews, technical debt tracking

License

Private