@mcpbox/taskagent
v2.0.8
Published
TaskAgent Cloud plugin — RFC 8628 device-code pairing and /v1 API client
Readme
@mcpbox/taskagent@2 (Cloud + self-host)
MCPBox auth CLI for TaskAgent — RFC 8628 device-code pairing for TaskAgent Cloud and
bootstrap-token login for OSS self-host. Part of the @mcpbox
scope on mcpbox.ru. Canonical contract: docs/plugin-auth-v1.md.
npm: @mcpbox/taskagent
CLI binaries: mcpbox-taskagent (primary), taskagent (alias).
Cloud (default)
# Pair with TaskAgent Cloud
npx @mcpbox/taskagent login
# WSL / headless: skip auto-open (paste the printed URL into your Windows browser)
npx @mcpbox/taskagent login --no-open
# Verify /v1/cloud/session (401 → clear credentials + device re-pair)
npx @mcpbox/taskagent sessionLocal dev can override the hosted API:
TASKAGENT_CLOUD_URL=http://127.0.0.1:8081 npx @mcpbox/taskagent loginAgent setup
Generate per-agent install instructions for hosted MCP and optional plugins:
For Codex, this installs the canonical plugin from
tupical/taskagent/clients/codex-plugin
into ~/plugins/taskagent, registers it in the personal marketplace
(~/.agents/plugins/marketplace.json), and enables
taskagent@personal in ~/.codex/config.toml, so it appears as installed in
/plugins. During local development, set TASKAGENT_CODEX_PLUGIN_SOURCE to
override the canonical source path.
npx @mcpbox/taskagent setup --all
npx @mcpbox/taskagent setup codex
npx @mcpbox/taskagent setup cursor --workspace taskagent-cloudCodex uses the installed plugin's remote MCP + OAuth. Cursor and Claude setup
delegate to the canonical taskagent-cursor and taskagent-claude packages
from tupical/taskagent/clients.
Self-host (OSS :8080)
# After taskagent-server wrote bootstrap.token (~/.agents/taskagent/data/)
TASKAGENT_SELFHOST_URL=http://127.0.0.1:8080 npx @mcpbox/taskagent login --mode self-host
npx @mcpbox/taskagent session --mode self-hostMode switch
npx @mcpbox/taskagent use cloud
npx @mcpbox/taskagent use self-hostCredentials: ~/.agents/taskagent/credentials.json (schema v1, mode: cloud | self-host).
Override directory via TASKAGENT_AGENT_DIR. If ~/.config/taskagent/credentials.json exists, it is copied into the agent dir on first use.
On 401 / revoked token, cloud mode clears stored auth and prompts device-code re-pair (--no-repair disables auto re-pair on session).
