git log for your
whole dev life

AI-powered terminal session logger

shellscribe - ~/my-project
$ shellscribe start
✓ Session started [my-project]
$ npm run build
Build completed in 2.3s
$ git commit -m "feat: add new feature"
✓ Committed: a1b2c3d
$ shellscribe recap
┌─ Session Summary ─────────────────┐
│ • Built production bundle │
│ • Committed new feature code │
│ • Fixed 3 TypeScript warnings │
│ • Ran test suite (47 passed) │
└───────────────────────────────────┘
$

features

Capture every command, get AI-powered insights, never forget what you built

🪝

shell_hook

Captures every command with exit codes, timestamps, and working directory automatically.

📁

project_detection

Auto-tags sessions with git repo names. Know exactly what you worked on and when.

🤖

ai_summaries

Get 5-bullet session recaps powered by LiteLLM. Plain-English summaries of your work.

🔍

fuzzy_search

Search through your entire command history. Find that one command you ran weeks ago.

📊

export_reports

Generate markdown reports of your work. Perfect for standups and documentation.

📈

productivity_stats

Track your productivity with detailed stats. See your most used commands and peak hours.

commands

Simple CLI to manage your development sessions

shellscribe start [project]
Start a new development session (auto-detects project from git repo)
shellscribe recap
Get an AI-powered summary of your current/last session
shellscribe search "docker"
Search through your entire command history
shellscribe stats --days 7
View productivity statistics and insights
shellscribe export --today -o daily.md
Export your work to markdown for standups
shellscribe daily
Generate a quick daily standup report
shellscribe stats
┌─ Productivity Stats ──────────────┐
│ Last 7 days │
├───────────────────────────────────┤
│ Sessions: 24
│ Total Commands: 1,847
│ Avg Commands/Day: 264
│ Success Rate: 94.2%
│ Total Time: 32h 15m
├───────────────────────────────────┤
│ Top Commands: │
│ git commit 312 (16.9%) │
│ npm run 248 (13.4%) │
│ pytest 187 (10.1%) │
└───────────────────────────────────┘

100%

Local First

12+

AI Models

0

Telemetry

MIT

License

install

Get started in under 60 seconds

1

Clone the repository

git clone https://github.com/shellscribe/shellscribe.git && cd shellscribe

2

Run the installer

./install.sh — This sets up the virtual environment and shell hook.

3

Reload your shell

source ~/.bashrc or source ~/.zshrc

4

Start logging

shellscribe start — Begin your first session!

Ready to remember everything?

Stop forgetting what you built yesterday. Start logging your dev life today.