🚀 How to Use `npx agentdb` with Frontier Features

Current Situation

The NEW AgentDB CLI with frontier features (17 commands) is configured in the agentic-flow package:

Package: agentic-flow Binary: dist/agentdb/cli/agentdb-cli.js Features: Causal Memory, Reflexion, Skills, Nightly Learner, etc.

Testing Locally (Before Publishing)

Option 1: Link the Package Locally

cd /workspaces/agentic-flow/agentic-flow

# Build the package
npm run build

# Link it globally
npm link

# Now npx agentdb will use your local version
npx agentdb --help

Option 2: Use Node Directly

cd /workspaces/agentic-flow/agentic-flow
node dist/agentdb/cli/agentdb-cli.js --help

After Publishing to NPM

Once you publish agentic-flow package to npm, users can run:

# Install globally
npm install -g agentic-flow

# Or use npx directly (no install needed)
npx agentdb --help

Publish Checklist

Before publishing to npm:

✅ Verify CLI works locally

cd /workspaces/agentic-flow/agentic-flow
npm run build
node dist/agentdb/cli/agentdb-cli.js --help

✅ Test with npm link

npm link
npx agentdb --help

✅ Update version in package.json
✅ Publish to npm

npm publish

✅ Test the published version

npx agentdb@latest --help

What Users Will See

After publishing, when users run npx agentdb, they'll see:

█▀█ █▀▀ █▀▀ █▄░█ ▀█▀ █▀▄ █▄▄
█▀█ █▄█ ██▄ █░▀█ ░█░ █▄▀ █▄█

AgentDB CLI - Frontier Memory Features

USAGE:
  agentdb <command> <subcommand> [options]

CAUSAL COMMANDS:
  agentdb causal add-edge ...
  agentdb causal experiment create ...
  ...

REFLEXION COMMANDS:
  agentdb reflexion store ...
  agentdb reflexion retrieve ...
  ...

SKILL COMMANDS:
  agentdb skill create ...
  agentdb skill search ...
  ...

[And 8 more command categories with 17 total commands]

Current Package Structure

agentic-flow/
├── package.json
│   ├── "name": "agentic-flow"
│   ├── "bin": {
│   │     "agentic-flow": "dist/cli-proxy.js",
│   │     "agentdb": "dist/agentdb/cli/agentdb-cli.js"  ← THIS
│   │   }
├── src/
│   └── agentdb/
│       ├── cli/
│       │   └── agentdb-cli.ts  ← NEW CLI WITH 17 COMMANDS
│       ├── controllers/
│       │   ├── CausalMemoryGraph.ts
│       │   ├── CausalRecall.ts
│       │   ├── ExplainableRecall.ts
│       │   ├── NightlyLearner.ts
│       │   ├── ReflexionMemory.ts
│       │   └── SkillLibrary.ts
│       └── ...
└── dist/
    └── agentdb/
        └── cli/
            └── agentdb-cli.js  ← COMPILED CLI

Testing Right Now

To test npx agentdb locally RIGHT NOW:

cd /workspaces/agentic-flow/agentic-flow

# Unlink any old version
npm unlink -g agentdb 2>/dev/null || true
npm unlink -g agentic-flow 2>/dev/null || true

# Build and link
npm run build
npm link

# Test it
npx agentdb --help

# Should show the new ASCII banner and 17 commands!

Quick Test Commands

# Store an episode
AGENTDB_PATH=./test.db npx agentdb reflexion store \
  "test-1" "my_task" 0.95 true "Success!" "input" "output" 1000 500

# Retrieve it
AGENTDB_PATH=./test.db npx agentdb reflexion retrieve "my_task" 5 0.5

# Check stats
AGENTDB_PATH=./test.db npx agentdb db stats

Summary

✅ The CLI is ready - All 17 commands with frontier features are implemented ✅ Binary is configured - package.json has "agentdb": "dist/agentdb/cli/agentdb-cli.js" ✅ Works locally - Use npm link to test npx agentdb now 🚀 Ready to publish - When you publish to npm, npx agentdb will work globally

3.8 KiB Raw Blame History

🚀 How to Use npx agentdb with Frontier Features