axoniac

Command-line interface for the Axoniac agentic memory store.

Install

npm install -g axoniac

Quick Start

# Save your API key
axoniac auth login --key ax_your_key_here

# Create a memory
axoniac memories create -c "The user prefers dark mode"

# Search memories
axoniac memories search "user preferences"

# List your skills
axoniac skills list

Authentication

Axoniac supports two auth modes: API keys (ax_...) for agent-facing endpoints, and JWT tokens for dashboard/management endpoints.

# Store your key locally (saved to ~/.config/axoniac/config.json)
axoniac auth login --key ax_your_key_here

# Store with a custom API URL
axoniac auth login --key ax_your_key_here --url https://your-instance.com/api

# Check current config
axoniac auth status

# Clear stored credentials
axoniac auth logout

# Change API URL
axoniac auth set-url https://axoniac.com/api

You can also pass credentials per-command:

axoniac -k ax_your_key -p memories search "hello"

Or via environment variables:

export AXONIAC_API_KEY=ax_your_key
export AXONIAC_URL=https://axoniac.com/api

Priority: --key flag > AXONIAC_API_KEY env > stored config.

Memories

# Create a memory
axoniac memories create -c "The capital of France is Paris" -t fact
axoniac memories create -c "User completed onboarding" -t episode --tags "onboarding,milestone"

# Get a memory by ID
axoniac memories get <memory-id>

# Update a memory
axoniac memories update <memory-id> -c "Updated content"

# Delete a memory
axoniac memories delete <memory-id>

# Search memories (hybrid vector + full-text + graph)
axoniac memories search "user preferences" --limit 5

# List recent memories
axoniac memories recent --limit 20

# Batch create from a JSON file
axoniac memories batch -f memories.json

Memory Types

• fact - Factual knowledge
• episode - Events and experiences
• preference - User preferences
• log - Activity logs
• compaction - Compacted/summarized memories

Skills

# Create a skill
axoniac skills create -n "web-scraper" -d "Extract data from web pages" --tags "web,extraction"

# List all skills
axoniac skills list

# Get a skill by ID
axoniac skills get <skill-id>

# Delete a skill
axoniac skills delete <skill-id>

Search

# Unified search across memories and skills
axoniac search "data extraction" --limit 10

Associations (Knowledge Graph)

# Create an association between two memories
axoniac associations create --from <memory-id-1> --to <memory-id-2> --type related

# List associations for a memory
axoniac associations list <memory-id>

# Delete an association
axoniac associations delete <association-id>

Association Types

related, caused_by, contradicts, supersedes, part_of, references, temporal

Agent Search

Optimized search endpoints for agent use:

# Search memories (agent-optimized)
axoniac agent memories-search "recent interactions" --limit 5

# Search skills (agent-optimized)
axoniac agent skills-search "data processing" --limit 5

Graph

# Get the memory knowledge graph
axoniac graph memories

# Get the skills graph
axoniac graph skills

Embeddings

# Check memory embedding coverage
axoniac embeddings memory-stats

# Backfill missing memory embeddings
axoniac embeddings memory-backfill

# Check skill embedding coverage
axoniac embeddings skill-stats

# Backfill missing skill embeddings
axoniac embeddings skill-backfill

# Rebuild knowledge graph associations
axoniac embeddings rebuild-associations

Agents (Tenants)

Manage your agent namespaces. Requires a JWT token.

# List all agents
axoniac tenants list

# Create an agent
axoniac tenants create -n "my-agent"

# Get agent details
axoniac tenants get <agent-id>

# Delete an agent
axoniac tenants delete <agent-id>

API Keys

Manage API keys for your agents. Requires a JWT token.

# List all API keys
axoniac keys list

# Create a new API key
axoniac keys create -n "production-key" -t <tenant-id>

# Revoke an API key
axoniac keys delete <key-id>

Dashboard

Dashboard-level operations for managing agent resources. Requires a JWT token.

# Account overview
axoniac dashboard overview

# List memories for an agent
axoniac dashboard memories <tenant-id>

# Create a memory via dashboard
axoniac dashboard create-memory <tenant-id> -c "Some fact" -t fact

# List skills for an agent
axoniac dashboard skills <tenant-id>

# Get/set agent tool set
axoniac dashboard tool-set <tenant-id>
axoniac dashboard set-tool-set <tenant-id> --config '{"tools": ["search", "create"]}'

# Manage personas
axoniac dashboard personas <tenant-id>
axoniac dashboard browse-personas <tenant-id>
axoniac dashboard add-persona <tenant-id> --persona-id <id>
axoniac dashboard remove-persona <tenant-id> <persona-id>

# Manage skill packs
axoniac dashboard skill-packs <tenant-id>
axoniac dashboard install-skill-pack <tenant-id> --pack-id <id>
axoniac dashboard uninstall-skill-pack <tenant-id> <pack-id>

# Manage agent packs
axoniac dashboard agent-packs <tenant-id>
axoniac dashboard install-agent-pack <tenant-id> --pack-id <id>
axoniac dashboard uninstall-agent-pack <tenant-id> <pack-id>

# Embedding stats & graphs
axoniac dashboard embedding-stats <tenant-id>
axoniac dashboard skill-embedding-stats <tenant-id>
axoniac dashboard memory-graph <tenant-id>
axoniac dashboard skill-graph <tenant-id>

Packs

Browse and inspect agent packs.

# List all public agent packs
axoniac packs catalog

# Get a pack by content hash
axoniac packs get <hash>

# Get a full bundle (pack + soul + personas + skills)
axoniac packs bundle <hash>

# List installed packs for current agent
axoniac packs installed

# List trending packs
axoniac packs trending

Shop (Marketplace)

# Browse the marketplace
axoniac shop browse
axoniac shop browse --sort recent --query "trading"
axoniac shop browse --page 2 --per-page 10

# Get item details
axoniac shop get <item-id>
axoniac shop get-by-slug <slug>

# View pricing plans
axoniac shop plans

# View your library of purchased packs
axoniac shop library

# Check if you own a pack
axoniac shop check-ownership --pack-id <id>

Billing

# Get a checkout link to upgrade to Pro
axoniac billing checkout

# Get a link to the Stripe billing portal
axoniac billing portal

Global Options

| Flag | Env Var | Description | |---|---|---| | -k, --key <key> | AXONIAC_API_KEY | API key or JWT token | | -u, --url <url> | AXONIAC_URL | API base URL (default: https://axoniac.com/api) | | -p, --pretty | — | Pretty-print JSON output |

Output

All commands output JSON by default (compact). Use -p / --pretty for formatted output:

axoniac -p memories search "hello"

Pipe to jq for advanced filtering:

axoniac memories recent | jq '.[].content'

Configuration

Stored credentials are saved to ~/.config/axoniac/config.json.

Requirements

• Node.js 18+