NAVI — Project Context

Personal modular AI agent system. FastAPI backend + Ollama LLM + Vue webclient.

Server

.venv/bin/uvicorn navi.main:app --reload --reload-dir navi --port 8000

Path	What
`navi/core/agent.py`	Agent loop, planning, tool execution
`navi/profiles/`	Profile definitions (`secretary`, `server_admin`, `developer`)
`navi/api/websocket.py`	WebSocket handler + event replay
`tools/`	User tools (auto-loaded at startup)
`tools/enabled.json`	Tools enabled across all profiles
`persona.txt`	Global persona injected into every profile
`navi.db`	SQLite session store
`workspace/`	Persistent working files
`manuals/`	Tool manuals (served by `tool_manual`)

Detailed reference is in docs/. Query a specific file when you need depth:

filesystem(action="query", path="docs/<file>.md", question="your question")

File	Covers
`docs/agent.md`	Agent loop, 3-phase planning, thinking mechanics flags
`docs/profiles.md`	Profile fields, all config flags, how to add a profile
`docs/tools.md`	Built-in tools, user tool format, hot-reload
`docs/sessions.md`	Session model, dual-buffer, context compression
`docs/websocket.md`	WebSocket protocol, all event types, reconnect replay
`docs/memory.md`	Long-term memory system
`docs/api.md`	Full REST + WebSocket API reference with schemas
`docs/config.md`	All `.env` variables
`docs/architecture.md`	Component diagram, data flow, registry wiring

For detailed usage of any tool:

tool_manual("tool_name")

Manuals exist for: write_tool, spawn_agent, reflect, gmail, share_file.

To add a new tool: tool_manual("write_tool") — full format reference + working example.