# Install STRIVE

[Open the visual install page](https://striverun.app/install).

The session-end hook records nothing until you register a project. Nothing
leaves this machine until you press **Save run** in STRIVE or explicitly approve
a direct private save.

STRIVE captures selected real agent sessions and opens a local card for review.
Python 3.9+ is required to capture. No model API key is needed.

## Claude Code

For the two local preview tools, add the MCP server with one command:

```sh
claude mcp add strive -- uvx --from striverun strive-mcp
```

For the `strive` skill and optional capture hook, install the plugin, then
restart Claude Code:

```sh
claude plugin marketplace add Morkeeth/strive
claude plugin install strive@strive
```

Run `/strive:strive` and name the project and session you want to review.

## Cursor

[Add STRIVE's private preview tools to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=strive&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJzdHJpdmVydW4iLCJzdHJpdmUtbWNwIl19) (new one-click link).
This installs a local MCP server with `list_sessions` and `preview_session` only.
It does not install the `strive` skill or completion hook. Cursor will ask you to
review the server before adding it. If the link does not open the install
dialog, add the same server to `~/.cursor/mcp.json`:

```json
{"mcpServers":{"strive":{"command":"uvx","args":["--from","striverun","strive-mcp"]}}}
```

The local plugin and `strive` skill were verified in Cursor's Customize screen
and used to make a private preview. Python 3.9+ and `uvx` are required.

For the full STRIVE skill and optional local hook, use the local plugin route below.

Cursor's documented local plugin route loads a plugin from
`~/.cursor/plugins/local`. Clone the public source and copy the self-contained
plugin there:

```sh
git clone --depth 1 https://github.com/Morkeeth/strive.git strive-plugin-source
python3 strive-plugin-source/scripts/strive-plugin.py install cursor
```

Reload Cursor, open Customize → Plugins, and select STRIVE's `strive` skill.
Local plugin imports must be allowed. If another STRIVE marketplace plugin is
already installed, Cursor gives that one precedence.

## Codex

For the two local preview tools, add the MCP server with one command:

```sh
codex mcp add strive -- uvx --from striverun strive-mcp
```

For the `strive` skill, install the plugin, then start a new Codex session:

```sh
codex plugin marketplace add Morkeeth/strive
codex plugin add strive@strive
```

Invoke the `strive` skill in a new conversation.
The package contains the same local capture runtime. It does not install hooks
in Codex.

## ZIP fallback

If your editor cannot use the routes above, download the versioned archive in
`/plugins/release.json`, verify its SHA-256, and unzip it. From inside the
extracted `strive` folder, run `python3 scripts/strive-plugin.py install cursor`
or `python3 scripts/strive-plugin.py install claude`.

The installer refuses to overwrite an existing local package. To update it,
run the corresponding `uninstall` command first, then install again. Capture
history and other plugins remain untouched.

The blue local preview lets you add a caption and your selected photo, switch
projects, and download Post, Story or Square images. Downloads do not publish.
Review and save in STRIVE starts as Only me. Choose your audience separately.

Tell us what happened at https://striverun.app/?feedback: your editor, the action,
what you expected and what happened. Do not include tokens or raw transcripts.