Skip to content
/ ceevs Public

c⌐■■vs - terminal receipt printer for executive summaries

Notifications You must be signed in to change notification settings

picogrid/ceevs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

c⌐■■vs

github.com/picogrid/ceevs

Terminal session receipts for physical receipt printers.

Every command you run, printed on thermal paper. Your shell history made tangible.

    the commands flow like water
    through pipes and shells and time
    but paper holds the memory
    of every single line

    a click, a whir, a ribbon
    of thermal truth unfolds
    the work you did in silence
    now physically extolled

    no cloud will hold these secrets
    no server owns your past
    just paper in your pocket
    proof that the work will last

What is this?

c⌐■■vs captures work sessions and prints executive summaries to thermal receipt printers.

Raw events (commands, exit codes, timestamps) are captured via zsh hooks and Claude Code hooks, stored as JSONL, then summarized by a lightweight LLM (haiku/gemini) into 2-3 sentences describing what was accomplished—not a log of every command.

Receipts print when:

  • a Linear issue is marked done
  • a plan (linked to Linear) is completed
  • a Claude Code session ends
  • a terminal session closes (optional)

Receipt Template

my glasses

╔════════════════════════════╗
║      WORK RECEIPT          ║
║  <TIMESTAMP>               ║
╠════════════════════════════╣
║  <LINEAR_ISSUE>            ║
║  <USER>                    ║
╠════════════════════════════╣
║                            ║
║  <EXECUTIVE_SUMMARY>       ║
║                            ║
╠════════════════════════════╣
║  <METRICS>                 ║
╠════════════════════════════╣
║  <STATUS>                  ║
╚════════════════════════════╝
        ✂ - - - - - - -

Architecture

capture                    store                    output
───────────────────────────────────────────────────────────
zsh hooks            ─┐
claude hooks         ─┼──▶  ~/.receipts/  ──┬──▶  thermal printer
linear state change  ─┤     (JSONL)         │     (ESC/POS)
plan completion      ─┘                     └──▶  haiku summary

Directory Structure

~/.receipts/
├── sessions/     # terminal sessions
├── claude/       # claude code sessions
├── linear/       # linear issue receipts
├── plans/        # plan receipts (linked to linear)
└── summaries/    # executive summaries

Commands

ceevs print <file>     # print receipt
ceevs watch            # auto-print on triggers
ceevs linear <issue>   # print linear issue receipt
ceevs plan <name>      # print plan receipt
ceevs test             # test print
ceevs feed             # feed + cut
ceevs status           # printer status

Installation

See project.md for full setup. Quick start:

  1. Add receipt hooks to ~/.zshrc
  2. Add Claude hooks to ~/.claude/settings.json
  3. Connect thermal printer
  4. ceevs test

Why?

  • tangible proof of work
  • close a Linear issue → get a receipt
  • finish a plan → get a receipt
  • satisfying thermal printer sounds
  • your history, on paper, in your pocket

License

Public domain. Your history belongs to you.

About

c⌐■■vs - terminal receipt printer for executive summaries

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages