LLM Coding Toolkit

A CLI with helpful commands for coding with LLMs.

Requirements

• Node.js 20+
• A GitHub token with Pull requests (read-only) permission

Installation

bun install -g llm-coding-toolkit

pnpm install -g llm-coding-toolkit

npm install -g llm-coding-toolkit

Usage

llmct <command> [options]

Run llmct <command> --help for command-specific options.

review-comments

llmct review-comments

Fetches unresolved review threads from a PR, strips bot noise, and writes a clean markdown file to .llm-coding-toolkit/agent-reviews/. If there's a single open PR it's auto-selected; otherwise an interactive picker is shown. It also ensures .llm-coding-toolkit/ is added to your repo .gitignore.

messages

llmct messages

Save reusable message templates with variable placeholders ({{VarName:"default"}}). Pick a message, fill in variables, and the resolved text is copied to your clipboard. Templates are stored in ~/.config/llm-coding-toolkit/messages.json.

github

llmct github

GitHub CLI authentication and token management. Run without a subcommand to pick one interactively, or invoke a subcommand directly:

llmct github auth
llmct github add-token
llmct github list-tokens

auth authenticates the GitHub CLI (gh) with a stored token. It detects the current repo and uses the matching token entry (owner-specific or default); if no repo or matching token is found, an interactive token picker is shown. The token is piped to gh auth login --with-token so it never appears in command arguments or logs.

Commands

| Command | Description | | --- | --- | | review-comments | Collect unresolved PR review comments into a markdown file to pass to an LLM agent | | prs | List open pull requests for a repo | | github | Authenticate the GitHub CLI (gh) and manage API tokens (auth / add-token / list-tokens subcommands) | | autocomplete | Install shell autocomplete for llmct | | messages | Manage reusable message templates with variable substitution |

More examples

# Collect review comments for a specific repo
llmct review-comments --repo owner/repo

# List open PRs (auto-detects repo from git remote)
llmct prs

# List open PRs for a specific repo
llmct prs --repo owner/repo

# Add a token (press Enter for default, or enter an owner/org)
llmct github add-token

# List configured tokens
llmct github list-tokens

# Authenticate gh with the token matching the current repo
llmct github auth

# Install shell autocomplete for the current shell (zsh/bash/fish)
llmct autocomplete

# Add a new message template
llmct messages add

# Update or remove a message template
llmct messages update
llmct messages remove

Authentication

Before running review-comments or prs, add a GitHub token:

llmct github add-token

• Press Enter at the owner prompt to store a default token.
• Enter an organization/owner name to store a token for that specific owner.
• Tokens are stored in ~/.config/llm-coding-toolkit/config.json.

Stack

• Runtime: Bun — TypeScript executed directly, no build step needed for dev
• GitHub API: @octokit/rest
• Interactive prompts: @clack/prompts
• Terminal colors: picocolors
• Linting: ESLint + Prettier + typescript-eslint

Development

Run locally

./cli.ts <command> [options]

Build

make build

Compiles to dist/cli.mjs (Node-compatible).

Lint

make lint        # check for issues
make lint-fix    # auto-fix ESLint issues + type check

License

MIT