milestone-cli

A tiny, dependency-free terminal client for Milestone.

It speaks the remote MCP endpoint (JSON-RPC over HTTP) with an API key, so it reuses exactly the tools an LLM agent gets — there's no second API to maintain.

Install

npm install -g milestone-cli
# or run without installing:
npx milestone-cli mine

Requires Node 18+ (uses the built-in fetch).

Configure

export MILESTONE_URL=https://your-milestone.example.com   # default http://localhost:3939
export MILESTONE_TOKEN=mk_live_…                           # Settings → API Keys

You can also override the URL per-call with --url.

Commands

milestone mine                              what's assigned to you
milestone projects                          list projects
milestone search "<text|KEY-123>"           find issues
milestone new <projectId> "<title>" [--priority HIGH]
milestone move <issueId> <stateId>          change state
milestone branch <issueId>                  create a GitHub branch
milestone intake <projectId>                pending intake requests
milestone stats <projectId>                 velocity + cycle time
milestone --version
milestone --help

Example

milestone --url https://milestone.acme.dev projects
milestone new prj_123 "Fix the flaky test" --priority HIGH

License

MIT