> ## Documentation Index
> Fetch the complete documentation index at: https://gleanfeed.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Glean Feed CLI

> Run the feedback-to-roadmap-to-changelog loop from a repository, terminal, CI job, or coding agent.

The Glean Feed CLI is the recommended starting point for an indie developer who
wants product work to live beside the code. It connects one repository to one
workspace, gives humans concise terminal commands, and gives agents and CI a
stable JSON contract.

<Card title="Five-minute setup" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/rocket.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=1dfbf3c65c490009d6014cfb2bd08963" href="/api/cli-quickstart" width="24" height="24" data-path="icons/rocket.svg">
  Install the CLI, connect a workspace, capture feedback, connect an agent, move an accepted
  request, and draft a changelog entry.
</Card>

## What the CLI operates

* Read and create feedback, then update its stage or moderation status.
* Promote accepted feedback to the roadmap without losing votes or comments.
* Send accepted feedback to a configured Linear team.
* Create, update, schedule, review, and explicitly publish changelog entries.
* Import GitHub issues as feedback with dry-run, duplicate, and retry controls.
* Install the Glean Feed MCP endpoint for Codex, Claude Code, Cursor, or VS Code.
* Return deterministic JSON and exit codes for agents and CI.

## Install

Node.js 20 or later is required.

<CodeGroup>
  ```bash npm theme={null}
  npm install --global @gleanfeed/cli
  gleanfeed --version
  ```

  ```bash pnpm theme={null}
  pnpm add --global @gleanfeed/cli
  gleanfeed --version
  ```

  ```bash Run without installing theme={null}
  npx @gleanfeed/cli --version
  ```
</CodeGroup>

<Check>
  Installation succeeded when `gleanfeed --version` prints a semantic version and `gleanfeed --help`
  lists `auth`, `init`, `feedback`, `roadmap`, `changelog`, and `agent`.
</Check>

## Human and agent use the same contract

Interactive commands show readable previews and ask before customer-visible or
external writes. Agents and CI add `--json` for one machine-readable object and
`--yes` when an approval prompt cannot be answered. The flag changes output and
confirmation behavior; it does not widen scopes or change the selected workspace.

```bash theme={null}
gleanfeed feedback list --stage in_review
gleanfeed feedback list --stage in_review --json
```

An OAuth token or API key always fixes the workspace on the server. `--profile`
only selects a locally stored credential; no command accepts a workspace ID that
can override the authenticated workspace.

## Continue

<Columns cols={2}>
  <Card title="Quickstart" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/rocket.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=1dfbf3c65c490009d6014cfb2bd08963" href="/api/cli-quickstart" width="24" height="24" data-path="icons/rocket.svg">
    Complete and verify the first product loop.
  </Card>

  <Card title="Command reference" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/code.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=15116d3d5d15173f6794d19222b5cd17" href="/api/cli-reference" width="24" height="24" data-path="icons/code.svg">
    Find every command group and approval boundary.
  </Card>

  <Card title="Profiles and repository config" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/settings.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=d4398f3e42ef9eb4a14703e6992cf03e" href="/api/cli-profiles" width="24" height="24" data-path="icons/settings.svg">
    Understand selection, local credentials, and `.gleanfeed.json`.
  </Card>

  <Card title="Agents and CI" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/code.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=15116d3d5d15173f6794d19222b5cd17" href="/api/cli-agents-ci" width="24" height="24" data-path="icons/code.svg">
    Connect MCP clients and run noninteractive workflows.
  </Card>

  <Card title="Security" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/key.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=bef0e09f655d6e92652b5049ef64ab72" href="/api/cli-security" width="24" height="24" data-path="icons/key.svg">
    Store, scope, rotate, and revoke credentials safely.
  </Card>

  <Card title="Troubleshooting" icon="https://mintcdn.com/gleanfeed/XujswKjVl9A7LyQN/icons/help.svg?fit=max&auto=format&n=XujswKjVl9A7LyQN&q=85&s=80dc53b7e808bf82abb27666bc2452f5" href="/api/cli-troubleshooting" width="24" height="24" data-path="icons/help.svg">
    Diagnose auth, config, network, and MCP failures.
  </Card>
</Columns>

Use the [JavaScript SDK](/api/javascript-sdk) instead when trusted server code
needs typed, in-process access rather than a subprocess. Use [MCP](/api/mcp)
when an agent should operate Glean Feed through its own OAuth connection.