harvest

Harvest exposes an AI-powered HTTP API and web interface for querying code
knowledge graphs stored in Neo4j. Agents can connect to it to run commands
on remote machines.

Prerequisites
─────────────
A running Neo4j instance (not bundled in this snap).

Quick start
───────────
1. Set required credentials:

  snap set harvest \

    neo4j.password=<neo4j-password> \

    llm.primary.provider=anthropic \

    llm.primary.api-key=<llm-api-key> \

    auth.jwt-secret=$(openssl rand -base64 32)

2. Start the services:

  snap start harvest.serve

  snap start harvest.ui

3. Open http://localhost:3000 in your browser.

Snap configuration keys
───────────────────────
neo4j.host Neo4j hostname (default: localhost)
neo4j.port Neo4j bolt port (default: 7687)
neo4j.user Neo4j username (default: neo4j)
neo4j.password Neo4j password (required)
server.host API bind address (default: 127.0.0.1)
server.port API port (default: 8080)

LLM providers — define any number with user-chosen names:
llm.<name>.provider anthropic | gemini | openai-compatible
llm.<name>.api-key API key (setting this enables the provider)
llm.<name>.model Model name
llm.<name>.base-url Base URL (openai-compatible only)
llm.<name>.timeout-secs Per-request timeout (default: 120)
llm.<name>.max-retries Retry limit per request (default: 3)
llm.<name>.priority Lower = tried first on rate limits (default: 0)

Example — Anthropic primary, Gemini fallback:
snap set harvest \

 llm.primary.provider=anthropic llm.primary.api-key=sk-ant-... \

 llm.fallback.provider=gemini   llm.fallback.api-key=AIza... \

 llm.fallback.priority=1

agent.max-iterations Agent iteration limit (default: 20)
agent.compaction-threshold-chars Context compaction trigger (default: 40000)
agent.compaction-keep-last Messages kept after compaction (default: 6)
auth.jwt-secret JWT signing secret (required)
auth.allow-local-login Enable username/password login (default: true)
auth.google.client-id Google OAuth client ID (optional)
auth.google.client-secret Google OAuth client secret (optional)
auth.google.redirect-uri Google OAuth redirect URI (optional)
auth.oidc.issuer-url OIDC provider URL (optional)
auth.oidc.client-id OIDC client ID (optional)
auth.oidc.client-secret OIDC client secret (optional)
auth.oidc.redirect-uri OIDC redirect URI (optional)
auth.oidc.display-name OIDC provider display name (optional)
agents.public-url Public URL for agent callbacks (optional)
docs.dir Documentation directory (default: $SNAP_COMMON/docs)
ui.enable-docs Show docs page in web UI (default: false)
ui.host Web UI bind address (default: 127.0.0.1)
ui.port Web UI port (default: 3000)