@trekagent/cli

The trek command — a thin CLI over the Trek API (remote task tracker + cockpit for AI agents). Manage projects, epics, tasks, dependencies, comments, agent sessions, and guidance from your terminal.

Install

npm i -g @trekagent/cli # global `trek` command
# or run ad-hoc:
npx @trekagent/cli --help

Configuration

The CLI reads credentials from the environment (or a config file written by trek):

export TREK_API_URL="https://api.trekagent.io"
export TREK_TOKEN="trk_..."

Mint a token in the cockpit's Settings → Tokens. To wire Trek into a Claude Code project (skill + MCP + hooks) in one step, use the companion installer instead: npx @trekagent/claude init.

Usage

trek --help
trek projects list
trek tasks ready --project <id>
trek tasks claim <task-id>
trek tasks complete <task-id>

Publishing (maintainers)

The package is publish-ready:

• bin.trek → dist/index.js (built with a #!/usr/bin/env node shebang).
• files ships only dist + README.md.
• prepublishOnly runs the build, so the artifact is always fresh.
• The only runtime deps are commander and picocolors; @trek/shared is type-only (devDependency) and is erased at build time, so the published package has no workspace-protocol dependency.

npm run build      # produces dist/index.js
npm run typecheck  # tsc --noEmit
npm publish --access public        # from packages/cli (runs prepublishOnly first)

Publishing is automated by the GitHub Actions workflow for tags once npm Trusted Publishing is configured for @trekagent/cli.