Docs

Setup guide

Digg captures your approved AI-coding sessions, strips secrets and personal data on your machine, and pays you for the data, points for every session that enters the licensed corpus, plus 70% of the revenue when it is licensed. This guide walks you through setup end to end.

1. Choose how to run Digg

There are two ways to run Digg, and they use the same capture engine, so pick whichever fits how you work. You only need one.

2. Set up the terminal CLI

Requires Node 18 or newer (Node 22+ also captures Cursor's in-editor chat). Works on macOS and Linux.

  1. 1
    Install the CLI
    This downloads the digg command to a folder on your PATH.
    curl -fsSL https://digg.sh/cli.sh | bash
    If it warns that the folder is not on your PATH, copy the export PATH=… line it prints into your ~/.zshrc (or ~/.bashrc) and open a new terminal.
  2. 2
    Run guided setup
    One command signs you in, connects this machine, and starts capturing:
    digg
    Prefer to do it step by step? Run digg login, then digg connect, then digg start.
  3. 3
    Approve the sign-in in your browser
    Digg prints a link like https://app.digg.sh/link?code=… and a short confirm code. Open the link (you must be signed in to Digg in that browser), check the code matches, and approve. No account yet? Create one first.
  4. 4
    Confirm it is running
    digg status
    You should see Signed in: yes, Connected: yes, and Capturing: yes. From here, capture runs in the background and uploads on its own, with no further commands. Secrets are stripped before anything leaves your machine.
  5. 5
    Capture your past sessions (optional)
    To include the coding history you already have on disk, run:
    digg backfill
    then restart capture with digg stop and digg start. Already-uploaded events are skipped, so it is safe to run more than once.
  6. 6
    Watch it fill up
    Check anytime with digg earnings and digg sessions, or open your dashboard. Publish a session to Discover with digg share <id> public.
Good to know: after a reboot, run digg start again, the CLI does not auto-resume on restart yet.

3. Set up the editor extension

For VS Code or Cursor.

  1. 1
    Install the extension
    One line, auto-detects VS Code or Cursor and installs, even if the editor CLI is not on your PATH:
    curl -fsSL https://digg.sh/install.sh | bash
    Prefer to do it by hand, or want the raw .vsix? See the download page.
  2. 2
    Reload the editor
    Open the command palette with ⌘⇧P (Ctrl+Shift+P on Windows/Linux) and run Developer: Reload Window.
  3. 3
    Sign in
    In the command palette, run Digg: Sign in and approve in your browser. Capture starts automatically once you are signed in, there is no separate start step.
  4. 4
    Capture past sessions (optional)
    Run Digg: Re-capture past sessions to upload the history already on disk. Safe to run more than once.
  5. 5
    Watch it fill up
    Sessions land on your dashboard. Check status anytime with Digg: Workflow capture status.

4. How you earn

Per session

Every session that clears the quality bar and enters the licensed corpus earns a flat reward in points.

When it is licensed

When an AI team licenses your data, you receive 70% of the revenue on top, paid in USDC on Base.

Cash out

1,000 points = $1. Redeem to USDC from wallet & payouts.

Per-session rewards are capped during launch (a daily and a monthly ceiling) to keep things fair. Your dashboard shows how much of each window you have earned. Licensing revenue is never capped.

5. Privacy and redaction

Redaction happens on your machine, before anything is uploaded. Digg removes three classes of sensitive data and reports a counts-only summary per session, it never stores or shows the removed value itself:

When a batch reaches the server it is re-scanned as a second gate. Each session on your sessions page shows the exact counts removed and anything the server caught on re-scan. You can delete any session at any time.

6. Manage or stop capture

Terminal
  • digg stop pause capture
  • digg start resume
  • digg consent pause claude-code pause one tool
  • digg uninstall remove all Digg state
Editor
  • Digg: Pause workflow capture
  • Digg: Stop workflow capture
  • Digg: Remove workflow capture
  • Uninstalling the extension stops the daemon automatically

7. Command reference

CLI, the `digg` command
digg
Guided setup: sign in, connect this machine, and start capturing, all in one.
digg login
Sign in with the device-link flow (approve in your browser).
digg connect
Connect this machine for capture (enroll). Records your consent.
digg start
Start capturing in the background. Uploads run on their own from here.
digg stop
Stop capturing.
digg status
Show sign-in, connection, capture, and earnings status.
digg earnings
Your points: today, lifetime, redeemable, plus session-reward progress.
digg sessions
List your recent captured sessions. A filled dot means it is in the licensed corpus.
digg share <id> public|private
Publish a session to Discover, or make it private again.
digg backfill
Re-capture your existing on-disk history from before you installed Digg.
digg uninstall
Stop capture and remove all Digg state from this machine.
Editor, the command palette (⌘⇧P)
Digg: Sign in
Link this editor to your Digg account. Capture starts automatically once signed in.
Digg: Refresh (re-check sign-in, balance & ads)
Re-check your session and restart the capture daemon if it is stale.
Digg: Enable workflow capture
Turn capture on for approved repos (on by default after sign-in).
Digg: Capture this repository
Allow-list the current repo so its sessions are captured.
Digg: Re-capture past sessions
Upload your existing on-disk history from before you installed Digg.
Digg: Workflow capture status
Show what is being captured and where the daemon is.
Digg: Pause workflow capture
Temporarily stop capturing. Nothing is uploaded while paused.
Digg: Stop workflow capture
Stop the background daemon entirely.
Digg: Remove workflow capture (delete local data)
Stop capture and delete the local daemon and its state.

8. Troubleshooting

`command not found: digg` after installing the CLI+

The install directory is not on your PATH. The installer prints the exact line to add (for example export PATH="$HOME/.local/bin:$PATH"). Add it to your ~/.zshrc or ~/.bashrc, then open a new terminal.

`command not found: code` when installing the extension by hand+

Your editor's CLI is not on your PATH. Use the one-line installer (curl -fsSL https://digg.sh/install.sh | bash), which finds the app directly, or enable the CLI from the editor: ⌘⇧P → “Shell Command: Install ‘code’ command in PATH”.

Nothing is capturing / no sessions appear+

Run digg status (CLI) or Digg: Workflow capture status (editor). If it is not capturing, run digg start or sign in again. New sessions show up after the server curates them, which takes a short while, so give it a few minutes after you finish coding.

The sign-in link expired+

The device link is valid for a few minutes. Just run digg login again (or Digg: Sign in) to get a fresh link.

Capture stopped after I rebooted (CLI)+

The CLI runs capture as a background process that does not survive a restart yet. After a reboot, run digg start again. The editor extension resumes on its own when the editor reopens.

Cursor IDE chat is not being captured+

Cursor's in-editor chat lives in a database that needs Node 22 or newer to read. Claude Code and Codex capture on any Node 18+. Upgrade Node and run digg backfill to pick it up.

FAQ

What exactly gets captured?+

Your AI-coding sessions: the prompts you send, the tools the agent runs, the edits it makes, and how each task turned out. Nothing outside your coding sessions is touched: no browsing, no keystrokes in other apps, no files the agent never saw.

How is my private information protected?+

Secrets (API keys, tokens, private keys), PII (emails, IPs, phone numbers, cards), and your username in file paths are stripped on your machine, before anything leaves it. When a batch lands, the server re-scans it as a second gate. Every session shows a counts-only summary of exactly what was removed. Read the privacy policy.

Can I see and delete my sessions?+

Yes. Every captured session appears on your sessions page with its redaction summary. Delete any one and it is hard-removed, the session and all its events, from our database.

Can I use Digg without an editor extension?+

Yes, that is exactly what the CLI is for. Install it with curl -fsSL https://digg.sh/cli.sh | bash, then run digg. It uses the same capture engine as the extension.

What is Discover?+

Sessions their owners chose to make public: a feed of real AI-coding runs you can read end to end. Sharing is opt-in and per-session; your sessions stay private unless you publish them. Browse Discover.

Still stuck? support@digg.sh

Digg: Docs & setup guide