trace

Overview ¶

Command trace starts the Aleutian Trace API server.

Aleutian Trace provides AST-powered code intelligence with:

• Ephemeral code graphs (in-memory, rebuilt from source)
• Multi-language support (Go, Python, TypeScript, JavaScript, HTML, CSS)
• 30+ agentic tools for exploration, reasoning, and safety
• LLM-powered agent loop with tool calling

Usage:

go run ./cmd/trace
go run ./cmd/trace -port 9090

With Ollama (for agent loop):

OLLAMA_BASE_URL=http://localhost:11434 OLLAMA_MODEL=glm-4.7-flash go run ./cmd/trace

With context assembly (sends code to LLM):

OLLAMA_BASE_URL=http://localhost:11434 OLLAMA_MODEL=glm-4.7-flash go run ./cmd/trace -with-context

With tools enabled (LLM can use exploration tools):

OLLAMA_BASE_URL=http://localhost:11434 OLLAMA_MODEL=glm-4.7-flash go run ./cmd/trace -with-tools

Full features:

OLLAMA_BASE_URL=http://localhost:11434 OLLAMA_MODEL=glm-4.7-flash go run ./cmd/trace -with-context -with-tools

Example requests:

# Health check
curl http://localhost:12217/v1/trace/health

# Get all available tools
curl http://localhost:12217/v1/trace/tools | jq

# Initialize a code graph
curl -X POST http://localhost:12217/v1/trace/init \
  -H "Content-Type: application/json" \
  -d '{"project_root": "/path/to/project"}'

# Run agent query (requires Ollama)
curl -X POST http://localhost:12217/v1/trace/agent/run \
  -H "Content-Type: application/json" \
  -d '{"project_root": "/path/to/project", "query": "What are the main entry points?"}'