thrust-cli

The local agent for Thrust — a proactive project director that watches your work, maintains your project context, and delivers your next move before you have to think about it.

What this does

thrust-cli runs on your machine as a lightweight background process. It watches your project folder for meaningful changes, connects to the Thrust cloud via your account, and keeps your project's context alive between sessions. You get a morning briefing in your inbox every day and a new Thrust delivered whenever you complete meaningful work.

Your source code never leaves your machine. What gets analyzed is behavioral context — file activity patterns, not file contents.

Requirements

Node.js v18 or higher. Run node -v to check. If you need to install or update, grab the LTS version from nodejs.org.

Installation

Install the CLI globally so it's available in any project folder:

npm install -g thrust-cli

Verify the install:

thrust --version

Getting started

1. Create your account

Before initializing a project, you need a Thrust account. Sign up at thrust.web.app. It takes under 30 seconds.

2. Initialize in your project

Navigate to your project root and run:

cd your-project-folder
thrust

This opens the local web console at http://localhost:8765 and walks you through connecting your project to your account. After that, the agent runs silently in the background and the terminal is all you need.

3. Keep it running

The agent only watches your project while the process is active. Run it in a background terminal tab or add it to your project startup script.

MCP server

Thrust includes a local MCP (Model Context Protocol) server that exposes your active project context to any connected AI tool. Start it with:

thrust mcp

Once running, tools like Cursor, Claude Code, Windsurf, and n8n can read your project's requirements, active thrust, timeline, and milestone status directly. This means every AI suggestion is aware of what you are actually building and where you are in the process.

For step-by-step connection guides for each tool, see the Integration Guide.

Commands

| Command | What it does | |---|---| | thrust | Initialize Thrust and open the local console | | thrust mcp | Start the local MCP server for AI tool integrations | | thrust -v | Print the installed CLI version |

Links

Web Console — Manage your projects, view timelines, and configure briefings

Integration Guide — Connect Cursor, Claude Code, n8n, and other tools via MCP

Landing Page — Learn how Thrust works

Support — Questions or feedback

Privacy

The file watcher and MCP server run entirely on your machine. Raw source code, secrets, and file contents are never uploaded or stored. Thrust analyzes behavioral patterns only. Full details are on the privacy section of our site.

MIT License