# FlyDocs (npm · @flydocs/cli)

Spec-driven development workflow for AI agents: issue lifecycle, sessions, project updates.

- Trust score: 59/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-21

## Components

- npm · `@flydocs/cli`: 59/100 (this document), [markdown](https://verifymcp.io/servers/ai-flydocs-flydocs/flydocs-cli.md), [page](https://verifymcp.io/servers/ai-flydocs-flydocs/flydocs-cli)

## Channel facts

- Registry: `npm`
- Package: `@flydocs/cli`
- Version: `1.3.8`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-21.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 25 of 60 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 6/100
  - Repository check failed: no source repository is declared.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: no license is declared.
  - Actively maintained (last published 0 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 72/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 1365 tokens (~124/item across 11 items; 11 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 88/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 59% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add ai-flydocs-flydocs -- npx -y @flydocs/cli
```

### Codex

```bash
codex mcp add ai-flydocs-flydocs -- npx -y @flydocs/cli
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-flydocs-flydocs": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@flydocs/cli"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ai-flydocs-flydocs --command npx --arg -y --arg @flydocs/cli
```

### Hermes

```yaml
mcp_servers:
  ai-flydocs-flydocs:
    command: "npx"
    args: ["-y", "@flydocs/cli"]
```

### Other

```json
{
  "mcpServers": {
    "ai-flydocs-flydocs": {
      "command": "npx",
      "args": [
        "-y",
        "@flydocs/cli"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-20 (score 59, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-08-19 (score 44)

First indexed and scored.

## MCP tools (11)

### `issue_get` (~78 tokens)

Get Issue

Read one issue with its status, description, and acceptance criteria. Read before you write.

Input parameters:

- `fields` (string)
- `ref` (string, required): Issue reference, e.g. FLY-123
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.

Output parameters:

- `ok` (boolean)

### `issue_list` (~149 tokens)

List Issues

List issues in the current focus — active sprint, board, or your assigned work.

Input parameters:

- `active` (boolean)
- `all` (boolean): Bypass the product scope cascade
- `assignee` (string)
- `board` (string): Board id, or 'active'
- `focused` (boolean)
- `limit` (integer)
- `milestone` (string)
- `mine` (boolean)
- `project` (string)
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.
- `sprint` (string): Sprint id, or 'active'
- `status` (string)

Output parameters:

- `ok` (boolean)

### `issue_create` (~171 tokens)

Create Issue

Capture a new issue. Procedure: stages/capture.md.

Input parameters:

- `assignee` (string): Provider id, or 'me'
- `description` (string): Required unless triage is true
- `estimate` (integer): Estimate points on the provider scale — `flydocs run workspace.get-estimate-scale` reports it. See reference/priority-estimates.md
- `milestone` (string)
- `priority` (integer): 0 none, 1 urgent, 2 high, 3 medium, 4 low
- `project` (string)
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.
- `title` (string, required)
- `triage` (boolean)
- `type` (string, required)

Output parameters:

- `ok` (boolean)

### `issue_activate` (~121 tokens)

Activate Issue

Assign, transition and record session state in one call. Not transactional; re-running is safe. Procedure: stages/activate.md.

Input parameters:

- `assignee` (string, required): Provider id, or 'me'
- `comment` (string, required): Why the work is starting — the transition requires it
- `ref` (string, required): Issue reference, e.g. FLY-123
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.
- `status` (string): Defaults to IMPLEMENTING

Output parameters:

- `ok` (boolean)

### `issue_transition` (~152 tokens)

Transition Issue

Move an issue to a canonical status. The comment is required and templated: reference/comment-templates.md, reference/status-workflow.md.

Input parameters:

- `comment` (string, required): Never optional — no status moves silently
- `force` (string): Provider-native override for STATUS_NOT_REACHABLE
- `ref` (string, required): Issue reference, e.g. FLY-123
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.
- `status` (string, required): Canonical FlyDocs status: BACKLOG, READY, IMPLEMENTING, BLOCKED, REVIEW, TESTING, COMPLETE, ARCHIVED, CANCELED, DUPLICATE

Output parameters:

- `ok` (boolean)

### `issue_comment` (~72 tokens)

Comment on Issue

Post a comment. Templates: reference/comment-templates.md.

Input parameters:

- `body` (string, required)
- `ref` (string, required): Issue reference, e.g. FLY-123
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.

Output parameters:

- `ok` (boolean)

### `issue_acceptance_update` (~89 tokens)

Update Acceptance Criteria

Check, uncheck, defer or annotate acceptance criteria by id. Never rewrite the description to do this. See stages/implement.md.

Input parameters:

- `changes` (array, required)
- `ref` (string, required): Issue reference, e.g. FLY-123
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.

Output parameters:

- `ok` (boolean)

### `session_start` (~61 tokens)

Start Session

Load continuity: the active issue with AC progress, last session's summary, pending work and blockers. Procedure: session.md.

Input parameters:

- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.

Output parameters:

- `ok` (boolean)

### `session_wrap` (~127 tokens)

Wrap Session

End the session: write the handoff summary and post the project update from the filled wrap template. Procedure: session.md.

Input parameters:

- `blockers` (array)
- `body` (string): Filled session-wrap template; sections are enforced
- `health` (string): Omit to wrap without posting a project update
- `issues` (array)
- `notes` (string)
- `pending` (array)
- `project` (string)
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.

Output parameters:

- `ok` (boolean)

### `project_update` (~78 tokens)

Post Project Update

Post a mid-session project health update; end-of-session updates belong to session_wrap. See session.md.

Input parameters:

- `body` (string, required)
- `health` (string, required)
- `project` (string)
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.

Output parameters:

- `ok` (boolean)

### `change_context` (~133 tokens)

Change Context

See what an issue shipped: its pull requests, linked issues and decisions, each claim citing its source.

Input parameters:

- `limit` (integer): Per-section cap: pull requests, related issues, decisions
- `mode` (string): shipped: what the issue records. impact: blast radius (not yet)
- `repo` (string): Workspace repo to target. Defaults to the current repo, or the first repo at a multi-repo root.
- `target` (string, required): Issue reference, e.g. FLY-123. A module or topic string is accepted by the schema and answered with NOT_AVAILABLE until the graph lands

Output parameters:

- `ok` (boolean)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/ai-flydocs-flydocs/flydocs-cli#diagnostics

## Score history

- 2026-08-21: 59
- 2026-08-20: 59
- 2026-08-19: 44

## Links

- npm package: https://www.npmjs.com/package/@flydocs/cli
- Socket report: https://socket.dev/npm/package/@flydocs/cli
- Website: https://www.flydocs.ai/
- Changelog RSS feed: https://verifymcp.io/servers/ai-flydocs-flydocs/flydocs-cli.xml
- Changelog JSON feed: https://verifymcp.io/servers/ai-flydocs-flydocs/flydocs-cli.json
- HTML version of this page: https://verifymcp.io/servers/ai-flydocs-flydocs/flydocs-cli