astrivya

One install. Every package.

The astrivya meta-package installs the complete Astrivya suite for AI coding agents — the CLI, the MCP server, and every library — from a single npm install.

npm install -g astrivya      # global: astrivya + astrivya-mcp commands
npm install astrivya         # project: all @astrivya/* libraries

Installing astrivya pulls in:

| Package | Role | |---------|------| | @astrivya/cli | CLI + TUI: astrivya init, astrivya akg query, astrivya atlas | | @astrivya/mcp-server | MCP server: 14+ tools, stdio + HTTP | | @astrivya/akg-core | Knowledge graph engine (SQLite, hybrid search, graph reasoning) | | @astrivya/akg-indexer | Indexers: ADRs, agent logs, TODOs, embeddings | | @astrivya/plugin-api | Types & contracts for plugin authors | | @astrivya/plugin-runtime | Signed plugin download, verify, load |

The astrivya and astrivya-mcp commands are thin shims that run the CLI and MCP server from the installed packages — no duplicated code, no drift.

Quick start

npm install -g astrivya
astrivya init            # one-time wizard: index + health check
astrivya                 # interactive TUI
astrivya akg query "how does authentication work?"

Or connect the MCP server to any MCP-compatible client:

{
  "mcpServers": {
    "astrivya": {
      "command": "npx",
      "args": ["-y", "@astrivya/mcp-server"]
    }
  }
}

License

Apache 2.0 © Astrivya