Skip to main content

Quick Start // Initial Sync Sequence

Deploy your first AgentVault entity in under 10 minutes.

Prerequisites
  • Node.js 18+
  • dfx installed and reachable in PATH
  • AgentVault CLI installed (npm install -g agentvault)

1. Initialize Project Vessel​

agentvault init my-first-agent
cd my-first-agent

This creates a baseline project with config, source, and package metadata.

2. Activate Local ICP Runtime​

dfx start --background
dfx ping

3. Package Entity Artifacts​

agentvault package ./

This compiles the agent and prepares deterministic deployment output.

4. Deploy to Local Network​

agentvault deploy --network local

Capture the emitted canister ID from command output.

5. Verify Operational State​

agentvault status
agentvault info
agentvault health

6. Execute a Task​

agentvault exec --canister-id <YOUR_CANISTER_ID> "hello world"

7. Read and Preserve State​

agentvault show --canister-id <YOUR_CANISTER_ID>
agentvault backup --canister-id <YOUR_CANISTER_ID>
Divine Efficiency

Automate status, health, and backup checks in your local CI before promoting deployments.

Next Protocols​

GoalGuide
Complete operational walkthroughTutorial
Mainnet deployment strategyDeployment Guide
Multi-chain wallet operationsWallet Guide
Full command surfaceCLI Reference

Common Command Set​

# List all local agents
agentvault list

# View runtime logs
agentvault logs <canister-id>

# Fetch state for local reconstruction
agentvault fetch --canister-id <canister-id>

# Inspect cycle balance
agentvault cycles balance <canister-id>

Help​

agentvault --help
agentvault <command> --help

See Troubleshooting when commands fail or outputs diverge.