asobi 0.1.0

A persistent, project-local knowledge graph CLI for AI agents.
Documentation

Asobi

Asobi is a persistent, project-local knowledge graph CLI for AI agents. Agents use it to keep memory, track session state, and share context across conversations — stored in a local libSQL/SQLite file, no server required.

Features

  • Knowledge graph — entities, append-only (capped) observations, and directed relations.
  • Truths — durable key→value facts per entity for current state (status, version).
  • Fast search — search-nodes over FTS5 (porter stemming + BM25) with a substring fallback.
  • Lazy reads — read-graph/search-nodes return truths + counts; open-nodes returns the full body. Cheap to load, cheap on tokens.
  • Skills — install reusable agent instructions from a git repo or local path.
  • MCP server — asobi mcp serves the graph over stdio to MCP-aware clients.
  • Document tier (optional, --features documents) — ingest + semantic query over Markdown.

Installation

From crates.io (recommended)

cargo install asobi
# with the optional document tier (semantic ingest + query):
cargo install asobi --features documents

Prebuilt binary (cargo-binstall)

No compile — cargo-binstall pulls the binary from the GitHub release:

cargo binstall asobi

From source

cargo install --git https://github.com/azusachino/asobi

Or build locally with make build (graph/MCP CLI) or make build-documents (adds ingest/query/compact). Requires Rust 1.85+, Edition 2024.

Quick Start

asobi init                  # one-time setup (XDG); use --local for a project-scoped graph

# Store and recall context (names are hierarchical, e.g. ame:mobile-support:task-1)
asobi add-observations "my-project" "Decided to use WAL mode for concurrency"
asobi add-truth "my-project" "status" "in-progress"
asobi search-nodes "WAL"
asobi open-nodes "my-project"

Common Commands

  • asobi read-graph / search-nodes <q> / open-nodes <name>... — read the graph.
  • asobi add-truth <name> <key> <value> / delete-truth <name> <key> — manage truths.
  • asobi skills install <src> --all / update / skills / skills show <name> — manage skills (--all and update sync, pruning skills dropped upstream; --select is additive).
  • asobi mcp — run as an MCP stdio server.
  • asobi stats / export -o graph.json / import graph.json / reset — inspect & manage.

Development