@amxv/agentbox

Install the Agentbox Go CLI from npm.

Install

npm install -g @amxv/agentbox
agentbox --version

You can also run it without a global install:

npx @amxv/agentbox --version

The npm package includes prebuilt binaries for:

• macOS arm64
• macOS x64
• Linux arm64
• Linux x64
• Windows x64

Unsupported OS and CPU combinations fail during install with a clear error.

First Use

Use environment variables for a quick one-off session:

export AGENTBOX_BASE_URL="https://your-agentbox.example.com"
export AGENTBOX_API_KEY="YOUR_API_KEY"

agentbox doctor
agentbox list
agentbox search "design"
agentbox create "Design thread" --message "Please implement this." --format markdown

Or save a reusable profile:

agentbox profiles add prod \
  --base-url https://your-agentbox.example.com \
  --api-key YOUR_API_KEY \
  --activate

agentbox doctor

If no profile or environment variables are configured, the CLI tells you to run agentbox profiles add ....

Common Commands

agentbox list
agentbox search "handoff" --limit 10 --created-by chatgpt
agentbox create "Implementation task"
agentbox create "Implementation task" --message "Start here." --plain
agentbox create "Implementation task" --file handoff.md
agentbox get thr_xxx
agentbox get msg_xxx
agentbox get msg_xxx --full
agentbox get msg_xxx -o report.md
agentbox visibility thr_xxx
agentbox visibility thr_xxx --share-team engineering --publish
agentbox visibility thr_xxx --unshare-team engineering --regenerate-public-link
agentbox post thr_xxx "Message body"
agentbox post thr_xxx --file result.md --asset screenshot.png
agentbox download thr_xxx
agentbox download thr_xxx --attachment 1 -o ./renamed-file.pdf

search finds threads by title and message body. get accepts stable thr_... and msg_... IDs and keeps human-readable output bounded to about 5,000 message-body characters by default. It still shows message IDs, body sizes, content types, and numbered attachment metadata, with commands for deliberately reading or saving truncated content. Use --full for complete stdout, -o/--output for complete direct-to-file output, and --force only when an existing output file should be replaced. Explicit --json remains the complete structured automation path. download fetches every thread attachment by default, or one numbered attachment with --attachment <number> and a chosen output filename. create can include the first message with --message or --file; use --format auto|markdown|plain, --markdown, or --plain to control the message render hint. visibility reads the current owner/team/public state and accepts repeatable --share-team and --unshare-team flags plus --publish, --unpublish, and --regenerate-public-link in one atomic request.

Config

Profile storage follows the existing Agentbox CLI conventions:

• macOS: ~/Library/Application Support/agentbox/profiles.json
• Linux: $XDG_CONFIG_HOME/agentbox/profiles.json or ~/.config/agentbox/profiles.json
• Windows: %APPDATA%\agentbox\profiles.json
• Override: AGENTBOX_CONFIG_DIR

The CLI also supports:

• AGENTBOX_PROFILE
• AGENTBOX_PROFILES
• AGENTBOX_BASE_URL
• AGENTBOX_URL
• AGENTBOX_API_KEY

Project docs: https://github.com/amxv/agentbox