@tinybottleai/pathfinder-cli

Authenticated command-line connector for AI Pathfinder. Connect a coding tool (Claude Code, Cursor, Codex, or any MCP-capable tool) to your Pathfinder opportunities.

Install

npm install -g @tinybottleai/pathfinder-cli

Connect your account

pathfinder login

This opens your browser to sign in and authorize. The minted token is stored under ~/.pathfinder/ and can be revoked any time from your Pathfinder account Settings tab.

CLI commands

| Command | What it does | | --- | --- | | pathfinder login | Connect this machine to your Pathfinder account. | | pathfinder logout | Disconnect and delete the stored token. | | pathfinder mcp | Run the stdio MCP server (for a coding tool). | | pathfinder help | Show usage. |

Connect a coding tool

The package ships a stdio MCP server. Register it with your coding tool so the tool can read your Pathfinder opportunities in-session.

Claude Code:

claude mcp add pathfinder -- pathfinder mcp

For Cursor, Codex, or another tool, point its MCP config at the pathfinder mcp command.

Then ask the tool to list your opportunities and pull one up.

How it works

pathfinder mcp is a thin proxy. It forwards the tool's requests to Pathfinder's hosted connector (/api/mcp) using your stored token, so the tools are defined once on the server and the command-line and web connectors always match. The tools:

| Tool | What it returns | | --- | --- | | list_opportunities | Your opportunities (id, title, lifecycle). | | get_opportunity | One opportunity's brief, objectives, and method (Markdown). | | init_opportunity | A readiness kit (e.g. CLAUDE.md / AGENTS.md) to bootstrap a project. |

Scope is derived from your role: a team lead's connection reads the team's shared opportunities; everyone else reads their own.

Environment

| Variable | Purpose | | --- | --- | | PATHFINDER_API_URL | Override the Pathfinder API origin (default: production). | | PATHFINDER_CONFIG_DIR | Override the credential directory (default: ~/.pathfinder). |

Notes

• The token is bearer-only. It does not bypass per-route authorization on the server.
• The stdio MCP server writes JSON-RPC to stdout and diagnostics to stderr.