workscribe

Your work, automatically documented.

Workscribe runs quietly in the background, turns your terminal activity into structured work sessions, and lets an AI write your daily summary. You just code.

See how it works

Node.js 22+ · macOS · Linux · Works with Anthropic, OpenAI, Ollama and more

terminal
$workscribe summary
## chronicle (main) — 3h 10m
  • - Implemented weekly summary prompt and provider methods
  • - Fixed project name resolution via git remote origin
  • - Added Slack webhook integration to summary command

Three steps. Then it just runs.

workscribe was designed to disappear into your workflow. Set it up once, then forget it exists until you need a summary.

1

Install & init

One command to install, one to configure. Picks your AI provider and installs the shell hook.

terminal
$npm install -g @workscribe/cli && workscribe init
✓ Installed @workscribe/cli
? Select AI provider: (Use arrow keys)
❯ Anthropic
OpenAI
Ollama (local)
2

Work normally

Every command you run is silently captured, redacted, and stored locally in ~/.workscribe/

terminal
$git checkout -b feature/auth
Switched to new branch 'feature/auth'
$npm test
Tests: 42 passed, 42 total
$git commit -m "Add JWT middleware"
[feature/auth 3a2f1b8] Add JWT middleware
3

Get your summary

Run workscribe summary at any time. Sessions are grouped, summarised by AI, and printed as markdown.

terminal
$workscribe summary
## api-service (feature/auth) — 2h 15m
- Set up authentication feature branch
- Resolved failing test suite for token validation
- Committed authentication middleware fixes

Built for developers who ship.

workscribe stays out of your way. No popups, no forms, no interruptions. Just quiet, automatic documentation that appears when you need it.

Privacy-first

Your data stays local

Nothing leaves your machine except structured event categories sent to your AI provider on demand.

Credential-safe

Secrets never hit disk

Tokens, API keys, and passwords are redacted before any event is written.

Provider-agnostic

Use any AI

Anthropic, OpenAI, Ollama (fully offline), or any OpenAI-compatible endpoint.

Undo anything

Made a mistake?

workscribe undo removes the last captured event. --dry-run shows you what would be deleted first.

Weekly view

Week in review

workscribe summary --week produces a theme-based summary across all sessions since Monday.

Standup-ready

Post to Slack

workscribe summary --slack sends your summary straight to a configured webhook.

Everything in your terminal.

No browser tabs. No context switching. Just commands.

terminal
$workscribe summary
## api-service (feature/auth) — 2h 15m
  • - Set up authentication feature branch and installed JWT dependencies
  • - Resolved failing test suite for token validation logic
  • - Committed authentication middleware fixes
## infrastructure — 45m
  • - Restarted staging environment and verified deployment stability
  • - Investigated and resolved Docker networking issue in compose setup
Coming Soon

Capture work from your IDE.

Extensions for your favorite editors — so file saves, refactors, and test runs show up in your summary alongside terminal activity.

VS Code

Does not import @vscode/extension-telemetry. Respects your VS Code telemetry setting.

JetBrains

Does not register with JetBrains telemetry service. No usage data collected.

Neovim

No telemetry infrastructure exists in this ecosystem.

Jupyter

No telemetry infrastructure exists in this ecosystem.

Zero telemetry. Always.

Every extension follows the same principle: your activity data stays on your machine. No phone-home, no analytics, no usage tracking. Just local event capture that you control.

Bring your own AI.

Workscribe works with the providers you already use — or keeps everything offline with Ollama.

A

Anthropic

Claude

Default: claude-haiku-4-5

OpenAI

GPT

Default: gpt-4o-mini

🦙

Ollama

Local

Fully local, no API key needed

OpenAI-compatible

Any endpoint

Groq, Together, Mistral, and others

Configure with two commands:

terminal
$workscribe config set ai.provider anthropic
✓ Provider set to anthropic
$workscribe config set ai.apiKey sk-...
✓ API key configured

Start capturing in two minutes.

Node.js 22+, macOS or Linux.

terminal
$npm install -g @workscribe/cli
$workscribe init
✓ Ready to capture. Run `workscribe summary` anytime.