Skip to main content

AgentVault Documentation

AgentVault packages your AI agent, deploys it to an Internet Computer canister, and keeps it running with its own durable identity, multi-chain wallet, encrypted secrets, and versioned memory. This is the full reference for installing, deploying, operating, and securing it in production.

Before you start

Production use requires a funded ICP identity and cycles balance, plus secure handling of your wallet mnemonic. See Installation for setup details.

Get started​

StepWhat it coversStart here
1. InstallInstall the CLI and set up your ICP identityInstallation
2. DeployPackage and deploy your first agentQuick Start
3. OperateEnd-to-end lifecycle for real workloadsTutorial v1.0

The agent stack​

AgentVault is the runtime layer for long-running, autonomous agents: a durable place to execute (AgentVault). It pairs with the smallchat suite, which covers the other layers: picking the next tool, a memory that survives, and keeping that memory inside a token budget. The suite's 1.0 release is:

ProjectWhat it doesRelease
smallchat (repo, Swift)Semantic tool dispatch: resolves an intent to at most one tool and checks its arguments against the tool's JSON Schema@smallchat/core 1.0.0, SmallChat Swift package 1.0.0
Stenographer (repo)Conversation index with GraphRAG search, plus a hash-chained truth ledger@stenographer/core 1.0.0
Short-hand (repo)Progressive compaction of conversation history into a token-budgeted context frame@shorthand/core 1.0.0
Polytician (repo)Local-first MCP server for semantic memory (concepts as vectors, markdown and ThoughtForm JSON)polytician 3.0.0

AgentVault ships on its own schedule and does not depend on those packages. Its orchestration layer has its own selector-based dispatcher modeled on smallchat, and an MCP client for Polytician 3.0: agentvault orchestrate --polytician-entry adds the concepts most relevant to the task to Claude's prompt and saves each session's result as a concept, in the agent's own Polytician namespace. The push-all, pull and archive commands use Polytician's vault_* tools, which AgentVault turns on by passing Polytician its webapp's URL and token; pushes reach the memory_repo canister through webapp routes that sign with an identity the repo owner has authorized. See the Polytician guide. Stenographer and Short-hand are not integrated yet.

  • Ecosystem overview — what each project does and how they fit together.
  • Engineering guide — component reference, integration status, and a proposed roadmap (not yet scheduled) for wiring Stenographer and Short-hand into AgentVault's orchestration pipeline.
  • Cross-repo evaluation playbook — runbook for reproducing the ecosystem evaluation from within another repo in the stack.

Guides​

  • Deployment — local and mainnet canister operations.
  • Wallets — cross-chain custody and transaction flows.
  • Backups — snapshot, restore, and archival strategy.
  • MemoryRepo — git-style on-chain memory, and the identities that may write to it.
  • Polytician — semantic memory per agent, connected to AgentVault's webapp.
  • Monitoring — health checks, metrics, and alerting.
  • Containers — run agents in locked-down Docker containers with a credential proxy and encrypted snapshots.
  • Troubleshooting — fast diagnostics and recovery.

Reference​

Security​

Architecture​

  1. Installation
  2. Quick Start
  3. Tutorial v1.0
  4. Deployment and Wallets
  5. Backups and Monitoring
  6. Security Overview
  7. Ecosystem overview

Status​