CLI (acctl)

acctl is the operator and developer command-line interface for Asset Core. It wraps common workflows for running daemons, diagnostics, replay, and adapter management.

Prerequisites

Rust toolchain (stable)
Asset Core binaries built (cargo build --release)

Step 1 - Install acctl

Build the CLI from the repository:

cargo build --release -p acctl

The binary is at target/release/acctl.

Step 2 - View available commands

acctl --help

Available commands:

Command	Description
`run`	Launch daemon with config discovery
`tail`	Stream events from commit log
`replay`	Replay events offline for analysis
`snapshot`	Create or restore snapshots
`diag`	Run environment diagnostics
`adapters`	Launch protocol adapters
`bundle-debug`	Create debug archive for incidents

Step 3 - Run diagnostics

Check your environment and configuration:

acctl diag --print-config

This validates:

Configuration file paths
Commit log accessibility
Toolchain versions

Step 4 - Tail the commit log

Stream events as they’re committed:

acctl tail --commit-log /path/to/commit_log.log

Options:

Flag	Description
`--follow`	Continue streaming new events
`--format`	Output format: `json` or `summary`
`--from`	Start from specific sequence

Step 5 - Replay for analysis

Replay events offline to analyze state:

acctl replay \
  --commit-log /path/to/commit_log.log \
  --from 0 \
  --to 1000

Replay produces deterministic summaries without running the full daemon.

Step 6 - Create snapshots

Export current state as a JSON snapshot:

acctl snapshot create \
  --commit-log /path/to/commit_log.log \
  --output snapshot.json

Restore from snapshot:

acctl snapshot restore \
  --input snapshot.json \
  --commit-log /path/to/commit_log.log

Step 7 - Launch adapters

Start the MCP server for AI tool integration:

acctl adapters \
  --config /path/to/write.toml \
  --read-config /path/to/read.toml \
  --transport stdio

Options:

Flag	Description
`--transport`	Protocol: `stdio` or `sse`
`--port`	SSE listen port (SSE only)

Step 8 - Create debug bundles

Package artifacts for incident triage:

acctl bundle-debug \
  --config /path/to/write.toml \
  --output debug-bundle.tar.gz

The bundle includes:

Configuration files
Commit log segments
Checkpoints
Prometheus metrics scrape
Manifest with timestamps

Troubleshooting

”Config file not found”

Specify the full path to your configuration:

acctl run --config /absolute/path/to/config.toml

“Commit log not accessible”

Check file permissions and that the path exists:

ls -la /path/to/commit_log.log

“Adapter binary not found”

Build the adapters first:

cargo build --release -p assetcore-adapters

Environment variables

acctl respects these environment variables:

Variable	Description
`ASSETCORE_WRITE_URL`	Override write daemon URL
`ASSETCORE_READ_URL`	Override read daemon URL

Next steps

Deployment Basics - Running daemons in production
Health and Metrics - Monitoring endpoints
MCP Integration - Using the MCP adapter