Zest logo Zest
Docs / Claude Code

Claude Code

Track every Claude Code session, across every project on your machine.

Claude Code logo

Install

  1. 1

    Add the Marketplace

    Requirements: Node.js version 20 or higher. Open Claude Code and run the following command:

    /plugin marketplace add https://github.com/Winding-Labs/zest-claude
  2. 2

    Install the Plugin

    Run the command below. When Claude Code asks where to install, choose "User" scope so Zest tracks your sessions across every project (not just this one).

    /plugin install zest
  3. 3

    Reload Plugins

    Load the newly installed plugin so its commands are available. Run this before logging in:

    /reload-plugins
  4. 4

    Authenticate with Zest

    Authenticate your Claude Code instance with Zest. This also auto-configures the status line to show sync errors, plugin updates, and dev mode at the bottom of Claude Code:

    /zest:login
  5. 5

    Start Coding!

    The plugin works automatically in the background. You're all set!

Check it works

Run the status command in Claude Code. It shows your account and workspace, what synced in the last hour, what is still queued, whether the sync daemon is running, and whether this folder is tracked.

/zest:status

What it records

  • Every Claude Code session: your prompts, Claude's replies, the model and token counts.
  • The tools and skills Claude used, and the files it created, edited or deleted, with their diffs.
  • The branch, commit SHA and PR URL when Claude runs git commit or gh pr create, so a session links to its pull request.
  • Everything queues in ~/.claude-zest/queue/ and syncs every 60 seconds once you are logged in.

What it never sends

  • API keys, tokens and passwords: 40+ patterns, redacted on your machine before anything is queued. If redaction cannot start, nothing is captured.
  • Folders you turn off with /zest:ignore.
  • Anything while /zest:disable is on. Sessions stay in the local queue.

Troubleshooting

/zest:login is not recognized

The plugin is not loaded yet. Run /reload-plugins; if the command is still missing, reinstall the plugin.

Only one project shows up in Zest

The plugin was installed at Project or Local scope, which limits it to one repository. Uninstall it and run /plugin install zest again, choosing User scope.

Sessions are not syncing

Run /zest:status. If the daemon is not running, start a new Claude Code session. /zest:sync uploads the queue now; ~/.claude-zest/logs/sync.log shows what failed.

Updating the plugin

  1. 1

    Open Plugin Manager

    Open the plugin manager by running:

    /plugins
  2. 2

    Select Zest

    Navigate to "Installed" and select the Zest plugin.

  3. 3

    Update the Plugin

    Choose "Update Plugin" from the options.

  4. 4

    Restart Plugins

    Apply the update by running:

    /reload-plugins

Claude Code in Zest

Claude Code analytics shows what Zest does with these sessions, per engineer and per team.