rikrok 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Ferrao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,255 @@
+<p align="center"><img src="assets/wordmark.png" alt="Rik Rok" width="480"></p>
+
+# Rik Rok
+
+Tired of running six Claude Code or Codex sessions, then going back through every one to work out what it did and put yourself back in the loop?
+
+Imagine if your recaps came at you the same way you doomscroll.
+
+Welcome to Rik Rok.
+
+Rik Rok watches your coding-agent sessions. When one goes idle after real work, it writes a 30 to 45 second news-style recap, narrates it in your own voice, renders a vertical reel, and drops it into a swipe feed on your phone. Every reel ends with the single next step for that project, and when the session changed how something moves, the reel shows the flow. Reply to a reel and the comment can go straight back to the agent.
+
+Everything runs on your machine. Sessions are read from disk, scripts come from a local LLM, narration from a 20-second recording of you, rendering from Remotion. No cloud, no accounts, no telemetry. Your voice never leaves the machine.
+
+## Get started
+
+Three ways to run it. Pick one; they all end in the same feed.
+
+| | Scripts written by | Voice | Needs | Best for |
+|---|---|---|---|---|
+| **1. Claude writes it** (easiest) | Claude Code, headless, on your subscription | your own voice via `rikrok voice serve`, or the Mac voice | Claude Code installed, ffmpeg | anyone already using Claude Code |
+| **2. Local model** | Ollama or LM Studio | same | a local model server | keeping recaps entirely offline |
+| **3. Mac, one server** | oMLX | oMLX (same server) | Apple Silicon, oMLX | one process for scripts, voice and QA |
+
+The session already went through Claude, so asking Claude to write the recap adds nothing new; the voice and the render stay on your machine in every option.
+
+### 1. Claude writes it
+
+```bash
+npm install -g rikrok        # or: npx rikrok ...
+rikrok setup                 # answers: yes to Claude writing the recaps, yes to the hook, record your voice
+```
+
+That is the whole setup. From then on, when you leave a Claude Code session that did real work, a reel is built in the background and appears in the feed. By hand, the same thing is:
+
+```bash
+rikrok hook install          # SessionEnd hook: recap when you leave a session
+rikrok voice setup           # 22 seconds of you, see "Your own voice"
+rikrok voice serve           # a local cloning server, or skip and use the Mac voice for now
+rikrok feed                  # http://127.0.0.1:4870
+rikrok install               # keep the feed (and voice server) running at login
+```
+
+`rikrok watch` is the alternative trigger: it recaps sessions that go idle for 15 minutes, hook or no hook. Use both if you tend to leave sessions open.
+
+Want to see one first? `rikrok demo` renders a reel from a bundled sample session.
+
+### 2. Local model
+
+```bash
+ollama pull qwen3:8b
+export RIKROK_SCRIPT=local RIKROK_LLM_MODEL=qwen3:8b
+export RIKROK_LLM_EXTRA='{"think":false}'    # thinking models: keep the JSON clean
+rikrok backfill --limit 3 && rikrok feed
+```
+
+`rikrok setup` walks through this too (answer no to Claude writing the recaps). LM Studio works the same way on port 1234. No model reachable? Reels still ship with a plain template script built from commits, files and todos.
+
+### 3. Mac, one server: oMLX
+
+See "One server on a Mac: oMLX" under Configuration. `rikrok setup` finds it and wires everything.
+
+## When does a session earn a reel?
+
+Two triggers, same rules. The hook fires when you leave a session; the watcher catches sessions left open that go quiet. Neither reads a session while you are typing in it. Then the same checks: real work, and only what is new since the last recap.
+
+```mermaid
+flowchart LR
+  H["you leave a session<br/>(SessionEnd hook)"] --> C
+  A["~/.claude/projects<br/>*.jsonl, read only"] -- "watcher, every 60 s" --> B{"idle?<br/>no writes for 15 min"}
+  B -- yes --> C{"real work?<br/>10+ turns, 3+ tool calls"}
+  C -- yes --> D{"new since last recap?"}
+  D -- yes --> E["build reel<br/>max 4 / hour"]
+  B -. "still typing: check next minute" .-> A
+  C -. "too small: remember, wait for more" .-> A
+  A -. "older than 48 h: backlog, never auto-recapped" .-> F["rikrok backfill"]
+```
+
+| Rule | Value | Why |
+|---|---|---|
+| Idle bar | 15 min | No new lines in the log. A resumed session that goes quiet again gets a second reel covering only the new lines. |
+| Real work | 10 assistant turns, 3 tool calls | Below this the session is remembered but skipped, so a quick question never becomes a reel. |
+| Backlog cutoff | 48 h | Older sessions are history, not news. The first run backfills the 10 most recent instead. |
+| Rate limit | 4 an hour | A reel costs an LLM call, a handful of voice clips and a render. The rest queue for the next scan. |
+| Retries | 5 | LLM or voice server down: back off 2, 4, 8, 16, 32 minutes, then give up for this idle period. |
+
+All five are settings (`RIKROK_IDLE_MINUTES`, `RIKROK_MIN_TURNS`, `RIKROK_MIN_TOOLS`, `RIKROK_MAX_PER_HOUR`).
+
+## What goes into the script?
+
+The log is condensed to about a page of evidence and handed to the script writer (Claude Code headless, or your local model) with a fixed grammar. If the model fails twice, a template writes the same shape from the raw facts. A reel always ships.
+
+```mermaid
+flowchart LR
+  E["evidence (condensed)<br/>last 6 prompts you typed<br/>last 8 assistant notes<br/>15 files edited, 10 commands<br/>git log for the window<br/>todo list, last snapshot<br/>URLs it mentioned<br/>last recap's next step"] --> L["script writer<br/>Claude Code headless, or a local model<br/>strict JSON, 2 tries"]
+  L --> S["script (fixed grammar)<br/>headline + narration<br/>done / open counts<br/>2 to 4 plays with evidence<br/>flow: nodes, edges, what changed<br/>status: shipped, open<br/>next step: one action"]
+  L -. "invalid twice" .-> T["template fallback"] --> S
+  S --> N["narrate, one clip per beat<br/>clip length sets card time"] --> R["render 1080x1920"]
+```
+
+The script is the only creative step. Everything after it is timing: each card stays up as long as its narration runs, never under 2.2 seconds.
+
+## The reel, beat by beat
+
+Frames from the demo reel (a sample session). Every reel has this order; only the number of plays varies, two to four, and the flow beat appears only when the session changed how something moves. Click the strip for full size.
+
+<a href="assets/readme/beats.jpg"><img src="assets/readme/beats.jpg" alt="The five beats of a reel: headline, play, how it moves, status, next step" width="100%"></a>
+
+1. **Headline.** The outcome up front. Project name in its fixed accent colour, the one-line result, and a score bug: minutes active, done, open. Under it, the repo path and branch. Headline and narration come from the model; path, branch and minutes are facts from the log.
+2. **Play** (two to four). One thing that happened. A caption plus an evidence panel: files touched, commit lines, commands or a quote, animating in one by one. The model picks the plays; evidence lines must come from the log, never invented.
+3. **How it moves.** The flow the session built or changed: a user action reaching an API, data written somewhere, a job firing. Nodes in the order things happen, arrows drawn in as the narration reaches them, a dot travelling each arrow, the changed parts lit in the accent. The model returns nodes and edges backed by the session. Off with `RIKROK_FLOW=off`.
+4. **Status.** Where it stands. Shipped in cyan with ticks, open in red with circles. If the previous recap named a next step, the narration says whether it happened.
+5. **Next step.** The single next action on an accent card. Also printed under the reel in the feed, so you can act without replaying.
+
+## What you can do on a reel
+
+| Action | How | What happens | Talks back to the agent? |
+|---|---|---|---|
+| Watched | double-tap, button, or 80% played | Reel drops below unwatched ones. Saved next to the video. | no |
+| 2x | hold anywhere | Plays at double speed while held. | no |
+| Comment | speech bubble | Saved to the reel, then handed to your hook with the session id, lines covered, newer recaps, and a resume hint. | yes, through `RIKROK_COMMENT_HOOK` |
+| Archive | button | Hidden from the feed. The feed also auto-archives past 3 unwatched per project. | no |
+| Chain | badge | Shows when a newer recap of the same session exists; tap jumps to it. | no |
+| Details | button | Shipped, open, commits, URLs, copy path. | no |
+
+## On your phone
+
+The feed binds to `127.0.0.1` by default. To reach it from your phone, put it on a private network you already trust:
+
+- Tailscale: `RIKROK_BIND=0.0.0.0 rikrok feed`, then open `http://<your-mac>.<tailnet>.ts.net:4870`. If your tailscaled runs in userspace mode, use `tailscale serve --bg --https=8445 http://127.0.0.1:4870` instead and open the https URL.
+- Same Wi-Fi: `RIKROK_BIND=0.0.0.0 rikrok feed` and open `http://<mac-ip>:4870`.
+- Behind a Cloudflare tunnel with Access in front works well too.
+
+Add it to your home screen from the share sheet for the full-screen PWA. There is no login on the feed, so do not expose it to the public internet without something in front.
+
+Data lives in `~/.rikrok` (reels, sidecar JSON, state, render bundle, logs). Delete it to start over.
+
+## Configuration
+
+Environment variables, or the same keys in `~/.rikrok/config.json`. `rikrok config` prints what is in effect.
+
+| Variable | Default | What it does |
+|---|---|---|
+| `RIKROK_HOME` | `~/.rikrok` | Data directory |
+| `RIKROK_CLAUDE_DIR` | `~/.claude/projects` | Where Claude Code keeps sessions |
+| `RIKROK_SCRIPT` | `auto` | Who writes the script: `claude` (headless Claude Code), `local` (server below), `auto` = local if a model is set, else Claude if the CLI exists |
+| `RIKROK_CLAUDE_MODEL` / `_BIN` | `sonnet` / `claude` | Model alias and binary for the Claude path |
+| `RIKROK_LLM_URL` | `http://127.0.0.1:11434` | OpenAI-compatible chat server (Ollama, LM Studio, oMLX, vLLM) |
+| `RIKROK_LLM_MODEL` | unset | Model name. Unset means template scripts only |
+| `RIKROK_LLM_KEY` | unset | Bearer token if your server wants one |
+| `RIKROK_LLM_EXTRA` | `{}` | JSON merged into every chat request, e.g. `{"think":false}` (Ollama) or `{"chat_template_kwargs":{"enable_thinking":false}}` (oMLX, vLLM) |
+| `RIKROK_FLOW` | `on` | `off` drops the "how it moves" beat |
+| `RIKROK_VOICE` | `say:Samantha` on macOS, else `none` | `clone` (your voice), `say:<Voice>`, `openai-speech:<voice>`, `module:<path>`, `none` |
+| `RIKROK_CLONE_REF` / `_TEXT` / `_MODEL` | `~/.rikrok/voice/ref.wav`, `ref.txt`, `Qwen3-TTS-12Hz-1.7B-Base-bf16` | Reference clip, its transcript, and the cloning model on your speech server |
+| `RIKROK_CLONE_API` | `speech` | `voice-clone` for servers with a dedicated `/v1/audio/voice-clone` endpoint (set by `rikrok voice serve`) |
+| `RIKROK_VOICE_PORT` | `4873` | Port for `rikrok voice serve` |
+| `RIKROK_TTS_URL` / `_MODEL` / `_KEY` | LLM URL, `tts-1` | For `openai-speech`: any `/v1/audio/speech` server (Kokoro-FastAPI, oMLX Qwen3-TTS, LM Studio) |
+| `RIKROK_VOICE_FX` | `none` | `light` or `strong` robot treatment |
+| `RIKROK_STT_URL` / `_MODEL` / `_KEY` | unset | Enable transcribe-back QA via a `/v1/audio/transcriptions` server with word timestamps |
+| `RIKROK_PORT` / `RIKROK_BIND` | `4870` / `127.0.0.1` | Feed address |
+| `RIKROK_COMMENT_HOOK` | unset | Shell command run for every comment, JSON on stdin (see below) |
+| `RIKROK_IDLE_MINUTES` / `_MIN_TURNS` / `_MIN_TOOLS` | `15` / `10` / `3` | What counts as a finished, meaningful session |
+| `RIKROK_MAX_PER_HOUR` | `4` | Watcher rate limit |
+| `RIKROK_PROJECT_NAME_RE` | unset | Regex with one capture group applied to the session cwd to name the project, e.g. `workspaces/([^/]+)/` for worktree layouts |
+| `RIKROK_HANDLE` | unset | Handle shown on every reel |
+| `RIKROK_BROWSER` | unset | Path to a Chrome or Chromium binary if you would rather not let Remotion download one |
+
+### Your own voice
+
+```bash
+rikrok voice setup           # reads you a two-line script, records 22 seconds, plays it back, done
+rikrok voice setup --file me.wav --text "what I say in it"   # or bring a clip you already have
+rikrok voice test            # say a line in your voice
+```
+
+There is no training. The clip and its transcript are stored in `~/.rikrok/voice` and sent with every request to a local speech server that does zero-shot cloning. Nothing is uploaded anywhere.
+
+You need a speech server that can clone. The easy way:
+
+```bash
+rikrok voice serve           # installs and runs a local Qwen3-TTS server on :4873 (MLX on Apple Silicon)
+rikrok voice serve --fast    # the 0.6B model: smaller download, quicker, a little less like you
+```
+
+New in 0.4.0 and lightly tested so far; please open an issue with what breaks. It needs [uv](https://docs.astral.sh/uv/) and git, downloads the model from Hugging Face on first start (about 4.5 GB, or 1.5 GB for `--fast`), and points Rik Rok at itself. `rikrok install` keeps it running at login alongside the watcher and the feed. The server is the Apache-2.0 [Qwen3-TTS OpenAI FastAPI project](https://github.com/groxaxo/Qwen3-TTS-Openai-Fastapi); on Linux and Windows it runs on PyTorch (CPU unless you set `TTS_DEVICE=cuda`).
+
+Already running something that clones? Any server that takes `ref_audio` and `ref_text` on `/v1/audio/speech` (oMLX with Qwen3-TTS, for example) works with `RIKROK_TTS_URL` and `RIKROK_CLONE_MODEL`; set `RIKROK_CLONE_API=voice-clone` for servers that use the dedicated `/v1/audio/voice-clone` endpoint instead.
+
+### One server on a Mac: oMLX
+
+If you are on Apple Silicon and want the least moving parts, run [oMLX](https://github.com/jundot/omlx) (Apache-2.0, menu-bar app). One instance serves the script model, the Qwen3-TTS cloning model and whisper for narration QA on a single port, which is how Rik Rok's author runs it.
+
+1. Install: download the `.dmg` from oMLX's releases, or `brew install jundot/omlx/omlx`. The welcome screen picks a model folder and starts the server.
+2. In oMLX's model downloader, add a chat model (for example `mlx-community/Qwen3.5-35B-A3B-4bit` if you have the memory, or a 4B to 9B Qwen3.5 otherwise), `mlx-community/Qwen3-TTS-12Hz-1.7B-Base-bf16` for your voice, and a whisper model such as `whisper-large-v3-turbo`.
+3. `rikrok setup`. It finds oMLX on :8000 or :8800, copies the API key from `~/.omlx/settings.json`, picks the models it finds, and records your voice. Thinking is switched off for the script model automatically.
+
+### Other voices
+
+- `say:Samantha` (any voice from `say -v ?`): zero setup on a Mac, the fallback while your voice is not set up.
+- `openai-speech:<voice>`: point `RIKROK_TTS_URL` at a local speech server. Kokoro-FastAPI, oMLX with Qwen3-TTS presets, and LM Studio all speak this API.
+- `module:/path/to/voice.mjs`: your own engine. Export `{ name, available(), synth(text, outWavPath) }`. This is how a private voice clone stays private.
+- `none`: silent reels, captions carry the story.
+
+If the configured voice is unavailable, Rik Rok falls back to `say`, then to silence, and says so in the sidecar. The default voices are there so a reel always ships; the point is your own.
+
+### Comment hook
+
+Set `RIKROK_COMMENT_HOOK` to any command. For each comment it receives JSON on stdin:
+
+```json
+{ "reelId": "…", "source": "claude", "sessionId": "…", "project": "my-app", "cwd": "/Users/me/my-app",
+  "headline": "my-app: signup guarded", "coveredLines": { "from": 0, "to": 214 },
+  "newerRecaps": [], "resumeHint": "claude --resume <id>", "comment": "also cover checkout", "at": "…" }
+```
+
+A hook that opens the session back up with your note:
+
+```bash
+RIKROK_COMMENT_HOOK='jq -r ".comment" | xargs -I{} claude --resume "$(jq -r .sessionId)" -p "{}"'
+```
+
+Comments are always saved to the reel's sidecar JSON as well.
+
+## Privacy
+
+With "Claude writes it", the condensed evidence (about a page: your last prompts, the assistant's notes, file names, commands, git log) goes to Claude through your own Claude Code login, the same place the session itself already went. With a local model, nothing leaves the machine. Either way the voice clip, the narration and the render stay local unless you point `RIKROK_TTS_URL` at a remote server. The reels themselves contain session content (file names, commit lines, what you asked for), so share them the way you would share a terminal recording.
+
+## Requirements
+
+- Node 20.19 or newer
+- ffmpeg and ffprobe
+- git
+- A headless Chrome for rendering. Remotion downloads one on first use (a few hundred MB); `rikrok demo` triggers that download so the first real reel is not a surprise. If the download does not work on your machine, set `RIKROK_BROWSER` to any Chrome or Chromium.
+- Remotion's licence applies to you as the user: free for individuals and for companies of up to three people, a paid company licence above that. See remotion.dev/license.
+
+Linux: the watcher and feed run fine (`rikrok watch`, `rikrok feed`); `rikrok install` prints systemd user units instead of installing launchd agents. `say` is macOS only, so pick `openai-speech` or `none`.
+
+## Roadmap
+
+- Codex CLI sessions (`~/.codex/sessions`) as a second source. The source interface is already in place.
+- Gemini CLI, OpenCode, Cursor.
+- A screenshot of the running app as a play's visual when the session mentioned a live URL.
+- Push notification when a reel lands.
+
+## Development
+
+```bash
+git clone https://github.com/alexferrao/rikrok && cd rikrok && npm install
+npm test                  # parse, script, flow and props tests on the fixture session
+npm run demo              # full pipeline on the fixture: assets/demo.mp4
+npm run studio            # Remotion studio for the composition
+node scripts/gen-icon.mjs # regenerate the mark (macOS, needs Baskerville)
+```
+
+MIT.

package/assets/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="512" height="512"><defs><clipPath id="mc"><rect x="0" y="0" width="800" height="426.12"/></clipPath><clipPath id="mr"><path d="M289.8 211 L800 211 L800 490 L0 490 L0 360.45 L243.30444444444444 360.45 Z"/></clipPath></defs><rect width="512" height="512" rx="96" fill="#000"/><g transform="translate(256 256) scale(1.55369) translate(-291.18499594484996 -338.06)"><g style="mix-blend-mode:screen" transform="translate(-7.724 -5.406)"><g fill="#25F4EE"><g clip-path="url(#mr)"><path transform="translate(200 450) scale(0.146484375 -0.146484375)" d="M642 612L545 294Q524 225 524 204Q524 112 687 112L653 0L-23 0L11 112L32 112Q89 112 128.5 138Q168 164 202 275L455 1102Q465 1135 465 1153Q465 1245 322 1245L356 1356L1022 1356Q1300 1356 1415 1257.5Q1530 1159 1530 1011Q1530 902 1469.5 820.5Q1409 739 1305.5 692.5Q1202 646 1070 631Q1148 595 1225 363Q1281 196 1332.5 154Q1384 112 1466 112L1432 0L1035 0Q970 94 897 330Q854 469 822 523.5Q790 578 755.5 595Q721 612 642 612ZM675 720Q892 720 988 753Q1084 786 1137 869Q1190 952 1190 1042Q1190 1145 1118.5 1196.5Q1047 1248 904 1248Q889 1248 835 1245Z"/></g><g clip-path="url(#mc)"><g transform="translate(224.44444444444446 450) rotate(-2.127) scale(1.6269) translate(-247.20833333333334 -368)"><path transform="translate(200 450) scale(0.3 -0.3)" d="M155 269L251 609Q230 590 203.5 582Q177 574 151 574Q108 574 79 597Q50 620 50 663Q50 691 70 710.5Q90 730 121 730Q150 730 168.5 711.5Q187 693 187 662Q187 640 177 623Q177 617 189 617Q244 617 294 703L312 703L191 269Z" stroke="#25F4EE" stroke-width="8.20" stroke-linejoin="round" stroke-linecap="round" paint-order="stroke"/></g></g></g></g><g style="mix-blend-mode:screen" transform="translate(7.724 5.406)"><g fill="#FE2C55"><g clip-path="url(#mr)"><path transform="translate(200 450) scale(0.146484375 -0.146484375)" d="M642 612L545 294Q524 225 524 204Q524 112 687 112L653 0L-23 0L11 112L32 112Q89 112 128.5 138Q168 164 202 275L455 1102Q465 1135 465 1153Q465 1245 322 1245L356 1356L1022 1356Q1300 1356 1415 1257.5Q1530 1159 1530 1011Q1530 902 1469.5 820.5Q1409 739 1305.5 692.5Q1202 646 1070 631Q1148 595 1225 363Q1281 196 1332.5 154Q1384 112 1466 112L1432 0L1035 0Q970 94 897 330Q854 469 822 523.5Q790 578 755.5 595Q721 612 642 612ZM675 720Q892 720 988 753Q1084 786 1137 869Q1190 952 1190 1042Q1190 1145 1118.5 1196.5Q1047 1248 904 1248Q889 1248 835 1245Z"/></g><g clip-path="url(#mc)"><g transform="translate(224.44444444444446 450) rotate(-2.127) scale(1.6269) translate(-247.20833333333334 -368)"><path transform="translate(200 450) scale(0.3 -0.3)" d="M155 269L251 609Q230 590 203.5 582Q177 574 151 574Q108 574 79 597Q50 620 50 663Q50 691 70 710.5Q90 730 121 730Q150 730 168.5 711.5Q187 693 187 662Q187 640 177 623Q177 617 189 617Q244 617 294 703L312 703L191 269Z" stroke="#FE2C55" stroke-width="8.20" stroke-linejoin="round" stroke-linecap="round" paint-order="stroke"/></g></g></g></g><g fill="#fff"><g clip-path="url(#mr)"><path transform="translate(200 450) scale(0.146484375 -0.146484375)" d="M642 612L545 294Q524 225 524 204Q524 112 687 112L653 0L-23 0L11 112L32 112Q89 112 128.5 138Q168 164 202 275L455 1102Q465 1135 465 1153Q465 1245 322 1245L356 1356L1022 1356Q1300 1356 1415 1257.5Q1530 1159 1530 1011Q1530 902 1469.5 820.5Q1409 739 1305.5 692.5Q1202 646 1070 631Q1148 595 1225 363Q1281 196 1332.5 154Q1384 112 1466 112L1432 0L1035 0Q970 94 897 330Q854 469 822 523.5Q790 578 755.5 595Q721 612 642 612ZM675 720Q892 720 988 753Q1084 786 1137 869Q1190 952 1190 1042Q1190 1145 1118.5 1196.5Q1047 1248 904 1248Q889 1248 835 1245Z"/></g><g clip-path="url(#mc)"><g transform="translate(224.44444444444446 450) rotate(-2.127) scale(1.6269) translate(-247.20833333333334 -368)"><path transform="translate(200 450) scale(0.3 -0.3)" d="M155 269L251 609Q230 590 203.5 582Q177 574 151 574Q108 574 79 597Q50 620 50 663Q50 691 70 710.5Q90 730 121 730Q150 730 168.5 711.5Q187 693 187 662Q187 640 177 623Q177 617 189 617Q244 617 294 703L312 703L191 269Z" stroke="#fff" stroke-width="8.20" stroke-linejoin="round" stroke-linecap="round" paint-order="stroke"/></g></g></g></g></svg>

package/assets/wordmark.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 595 160" width="595" height="160"><defs><clipPath id="wc0c"><rect x="0" y="0" width="800" height="426.12"/></clipPath><clipPath id="wc0r"><path d="M289.8 211 L800 211 L800 490 L0 490 L0 360.45 L243.30444444444444 360.45 Z"/></clipPath></defs><defs><clipPath id="wc4c"><rect x="0" y="0" width="800" height="426.12"/></clipPath><clipPath id="wc4r"><path d="M289.8 211 L800 211 L800 490 L0 490 L0 360.45 L243.30444444444444 360.45 Z"/></clipPath></defs><defs><clipPath id="wr0c"><rect x="0" y="0" width="800" height="426.12"/></clipPath><clipPath id="wr0r"><path d="M289.8 211 L800 211 L800 490 L0 490 L0 360.45 L243.30444444444444 360.45 Z"/></clipPath></defs><defs><clipPath id="wr4c"><rect x="0" y="0" width="800" height="426.12"/></clipPath><clipPath id="wr4r"><path d="M289.8 211 L800 211 L800 490 L0 490 L0 360.45 L243.30444444444444 360.45 Z"/></clipPath></defs><defs><clipPath id="ww0c"><rect x="0" y="0" width="800" height="426.12"/></clipPath><clipPath id="ww0r"><path d="M289.8 211 L800 211 L800 490 L0 490 L0 360.45 L243.30444444444444 360.45 Z"/></clipPath></defs><defs><clipPath id="ww4c"><rect x="0" y="0" width="800" height="426.12"/></clipPath><clipPath id="ww4r"><path d="M289.8 211 L800 211 L800 490 L0 490 L0 360.45 L243.30444444444444 360.45 Z"/></clipPath></defs><rect width="595" height="160" rx="24" fill="#000"/><g transform="translate(28 28) scale(0.46872) translate(-159.36999188969992 -227.11999999999998)"><g style="mix-blend-mode:screen" transform="translate(-10.667307692307693 -7.467115384615385)"><g transform="translate(0.00 0)"><g fill="#25F4EE"><g clip-path="url(#wc0r)"><path transform="translate(200 450) scale(0.146484375 -0.146484375)" d="M642 612L545 294Q524 225 524 204Q524 112 687 112L653 0L-23 0L11 112L32 112Q89 112 128.5 138Q168 164 202 275L455 1102Q465 1135 465 1153Q465 1245 322 1245L356 1356L1022 1356Q1300 1356 1415 1257.5Q1530 1159 1530 1011Q1530 902 1469.5 820.5Q1409 739 1305.5 692.5Q1202 646 1070 631Q1148 595 1225 363Q1281 196 1332.5 154Q1384 112 1466 112L1432 0L1035 0Q970 94 897 330Q854 469 822 523.5Q790 578 755.5 595Q721 612 642 612ZM675 720Q892 720 988 753Q1084 786 1137 869Q1190 952 1190 1042Q1190 1145 1118.5 1196.5Q1047 1248 904 1248Q889 1248 835 1245Z"/></g><g clip-path="url(#wc0c)"><g transform="translate(224.44444444444446 450) rotate(-2.127) scale(1.6269) translate(-247.20833333333334 -368)"><path transform="translate(200 450) scale(0.3 -0.3)" d="M155 269L251 609Q230 590 203.5 582Q177 574 151 574Q108 574 79 597Q50 620 50 663Q50 691 70 710.5Q90 730 121 730Q150 730 168.5 711.5Q187 693 187 662Q187 640 177 623Q177 617 189 617Q244 617 294 703L312 703L191 269Z" stroke="#25F4EE" stroke-width="8.20" stroke-linejoin="round" stroke-linecap="round" paint-order="stroke"/></g></g></g></g><path transform="translate(209.63 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#25F4EE" d="M736 1228Q736 1164 690 1118Q644 1072 580 1072Q516 1072 470 1118Q424 1164 424 1228Q424 1293 470 1338.5Q516 1384 580 1384Q644 1384 690 1338.5Q736 1293 736 1228ZM568 242L669 242Q541 -31 311 -31Q218 -31 171 8Q124 47 124 124Q124 169 163 282L283 627Q297 667 297 679Q297 691 291.5 696.5Q286 702 274 702Q223 702 154 572L58 572Q187 851 422 851Q505 851 551 810.5Q597 770 597 699Q597 647 556 534L440 218Q415 151 415 134Q415 123 421.5 117Q428 111 440 111Q466 111 506.5 156Q547 201 568 242Z"/><path transform="translate(303.67 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#25F4EE" d="M61 0L412 1149Q422 1181 422 1199Q422 1252 297 1252L329 1356Q579 1356 686 1384L781 1384L516 515Q765 756 867 803.5Q969 851 1050 851Q1121 851 1166 821.5Q1211 792 1211 744Q1211 703 1181.5 672Q1152 641 1098 641Q1051 641 997 675Q964 696 934 696Q830 696 642 515Q723 515 791.5 476.5Q860 438 885 378Q910 318 920 194Q926 113 959 113Q1008 113 1084 255L1176 255Q1070 -14 822 -14Q739 -14 679 29Q619 72 619 155Q619 189 631 259Q642 328 642 354Q642 439 562 439L464 345L358 0Z"/><g transform="translate(562.05 0)"><g fill="#25F4EE"><g clip-path="url(#wc4r)"><path transform="translate(200 450) scale(0.146484375 -0.146484375)" d="M642 612L545 294Q524 225 524 204Q524 112 687 112L653 0L-23 0L11 112L32 112Q89 112 128.5 138Q168 164 202 275L455 1102Q465 1135 465 1153Q465 1245 322 1245L356 1356L1022 1356Q1300 1356 1415 1257.5Q1530 1159 1530 1011Q1530 902 1469.5 820.5Q1409 739 1305.5 692.5Q1202 646 1070 631Q1148 595 1225 363Q1281 196 1332.5 154Q1384 112 1466 112L1432 0L1035 0Q970 94 897 330Q854 469 822 523.5Q790 578 755.5 595Q721 612 642 612ZM675 720Q892 720 988 753Q1084 786 1137 869Q1190 952 1190 1042Q1190 1145 1118.5 1196.5Q1047 1248 904 1248Q889 1248 835 1245Z"/></g><g clip-path="url(#wc4c)"><g transform="translate(224.44444444444446 450) rotate(-2.127) scale(1.6269) translate(-247.20833333333334 -368)"><path transform="translate(200 450) scale(0.3 -0.3)" d="M155 269L251 609Q230 590 203.5 582Q177 574 151 574Q108 574 79 597Q50 620 50 663Q50 691 70 710.5Q90 730 121 730Q150 730 168.5 711.5Q187 693 187 662Q187 640 177 623Q177 617 189 617Q244 617 294 703L312 703L191 269Z" stroke="#25F4EE" stroke-width="8.20" stroke-linejoin="round" stroke-linecap="round" paint-order="stroke"/></g></g></g></g><path transform="translate(771.67 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#25F4EE" d="M92 345Q92 450 153.5 570.5Q215 691 346.5 771Q478 851 659 851Q884 851 989.5 744Q1095 637 1095 485Q1095 276 933 122.5Q771 -31 519 -31Q336 -31 214 61.5Q92 154 92 345ZM385 244Q385 155 418.5 110.5Q452 66 519 66Q643 66 721.5 253Q800 440 800 569Q800 667 762.5 711Q725 755 676 755Q544 755 464.5 559Q385 363 385 244Z"/><path transform="translate(931.35 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#25F4EE" d="M61 0L412 1149Q422 1181 422 1199Q422 1252 297 1252L329 1356Q579 1356 686 1384L781 1384L516 515Q765 756 867 803.5Q969 851 1050 851Q1121 851 1166 821.5Q1211 792 1211 744Q1211 703 1181.5 672Q1152 641 1098 641Q1051 641 997 675Q964 696 934 696Q830 696 642 515Q723 515 791.5 476.5Q860 438 885 378Q910 318 920 194Q926 113 959 113Q1008 113 1084 255L1176 255Q1070 -14 822 -14Q739 -14 679 29Q619 72 619 155Q619 189 631 259Q642 328 642 354Q642 439 562 439L464 345L358 0Z"/></g><g style="mix-blend-mode:screen" transform="translate(10.667307692307693 7.467115384615385)"><g transform="translate(0.00 0)"><g fill="#FE2C55"><g clip-path="url(#wr0r)"><path transform="translate(200 450) scale(0.146484375 -0.146484375)" d="M642 612L545 294Q524 225 524 204Q524 112 687 112L653 0L-23 0L11 112L32 112Q89 112 128.5 138Q168 164 202 275L455 1102Q465 1135 465 1153Q465 1245 322 1245L356 1356L1022 1356Q1300 1356 1415 1257.5Q1530 1159 1530 1011Q1530 902 1469.5 820.5Q1409 739 1305.5 692.5Q1202 646 1070 631Q1148 595 1225 363Q1281 196 1332.5 154Q1384 112 1466 112L1432 0L1035 0Q970 94 897 330Q854 469 822 523.5Q790 578 755.5 595Q721 612 642 612ZM675 720Q892 720 988 753Q1084 786 1137 869Q1190 952 1190 1042Q1190 1145 1118.5 1196.5Q1047 1248 904 1248Q889 1248 835 1245Z"/></g><g clip-path="url(#wr0c)"><g transform="translate(224.44444444444446 450) rotate(-2.127) scale(1.6269) translate(-247.20833333333334 -368)"><path transform="translate(200 450) scale(0.3 -0.3)" d="M155 269L251 609Q230 590 203.5 582Q177 574 151 574Q108 574 79 597Q50 620 50 663Q50 691 70 710.5Q90 730 121 730Q150 730 168.5 711.5Q187 693 187 662Q187 640 177 623Q177 617 189 617Q244 617 294 703L312 703L191 269Z" stroke="#FE2C55" stroke-width="8.20" stroke-linejoin="round" stroke-linecap="round" paint-order="stroke"/></g></g></g></g><path transform="translate(209.63 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#FE2C55" d="M736 1228Q736 1164 690 1118Q644 1072 580 1072Q516 1072 470 1118Q424 1164 424 1228Q424 1293 470 1338.5Q516 1384 580 1384Q644 1384 690 1338.5Q736 1293 736 1228ZM568 242L669 242Q541 -31 311 -31Q218 -31 171 8Q124 47 124 124Q124 169 163 282L283 627Q297 667 297 679Q297 691 291.5 696.5Q286 702 274 702Q223 702 154 572L58 572Q187 851 422 851Q505 851 551 810.5Q597 770 597 699Q597 647 556 534L440 218Q415 151 415 134Q415 123 421.5 117Q428 111 440 111Q466 111 506.5 156Q547 201 568 242Z"/><path transform="translate(303.67 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#FE2C55" d="M61 0L412 1149Q422 1181 422 1199Q422 1252 297 1252L329 1356Q579 1356 686 1384L781 1384L516 515Q765 756 867 803.5Q969 851 1050 851Q1121 851 1166 821.5Q1211 792 1211 744Q1211 703 1181.5 672Q1152 641 1098 641Q1051 641 997 675Q964 696 934 696Q830 696 642 515Q723 515 791.5 476.5Q860 438 885 378Q910 318 920 194Q926 113 959 113Q1008 113 1084 255L1176 255Q1070 -14 822 -14Q739 -14 679 29Q619 72 619 155Q619 189 631 259Q642 328 642 354Q642 439 562 439L464 345L358 0Z"/><g transform="translate(562.05 0)"><g fill="#FE2C55"><g clip-path="url(#wr4r)"><path transform="translate(200 450) scale(0.146484375 -0.146484375)" d="M642 612L545 294Q524 225 524 204Q524 112 687 112L653 0L-23 0L11 112L32 112Q89 112 128.5 138Q168 164 202 275L455 1102Q465 1135 465 1153Q465 1245 322 1245L356 1356L1022 1356Q1300 1356 1415 1257.5Q1530 1159 1530 1011Q1530 902 1469.5 820.5Q1409 739 1305.5 692.5Q1202 646 1070 631Q1148 595 1225 363Q1281 196 1332.5 154Q1384 112 1466 112L1432 0L1035 0Q970 94 897 330Q854 469 822 523.5Q790 578 755.5 595Q721 612 642 612ZM675 720Q892 720 988 753Q1084 786 1137 869Q1190 952 1190 1042Q1190 1145 1118.5 1196.5Q1047 1248 904 1248Q889 1248 835 1245Z"/></g><g clip-path="url(#wr4c)"><g transform="translate(224.44444444444446 450) rotate(-2.127) scale(1.6269) translate(-247.20833333333334 -368)"><path transform="translate(200 450) scale(0.3 -0.3)" d="M155 269L251 609Q230 590 203.5 582Q177 574 151 574Q108 574 79 597Q50 620 50 663Q50 691 70 710.5Q90 730 121 730Q150 730 168.5 711.5Q187 693 187 662Q187 640 177 623Q177 617 189 617Q244 617 294 703L312 703L191 269Z" stroke="#FE2C55" stroke-width="8.20" stroke-linejoin="round" stroke-linecap="round" paint-order="stroke"/></g></g></g></g><path transform="translate(771.67 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#FE2C55" d="M92 345Q92 450 153.5 570.5Q215 691 346.5 771Q478 851 659 851Q884 851 989.5 744Q1095 637 1095 485Q1095 276 933 122.5Q771 -31 519 -31Q336 -31 214 61.5Q92 154 92 345ZM385 244Q385 155 418.5 110.5Q452 66 519 66Q643 66 721.5 253Q800 440 800 569Q800 667 762.5 711Q725 755 676 755Q544 755 464.5 559Q385 363 385 244Z"/><path transform="translate(931.35 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#FE2C55" d="M61 0L412 1149Q422 1181 422 1199Q422 1252 297 1252L329 1356Q579 1356 686 1384L781 1384L516 515Q765 756 867 803.5Q969 851 1050 851Q1121 851 1166 821.5Q1211 792 1211 744Q1211 703 1181.5 672Q1152 641 1098 641Q1051 641 997 675Q964 696 934 696Q830 696 642 515Q723 515 791.5 476.5Q860 438 885 378Q910 318 920 194Q926 113 959 113Q1008 113 1084 255L1176 255Q1070 -14 822 -14Q739 -14 679 29Q619 72 619 155Q619 189 631 259Q642 328 642 354Q642 439 562 439L464 345L358 0Z"/></g><g transform="translate(0.00 0)"><g fill="#fff"><g clip-path="url(#ww0r)"><path transform="translate(200 450) scale(0.146484375 -0.146484375)" d="M642 612L545 294Q524 225 524 204Q524 112 687 112L653 0L-23 0L11 112L32 112Q89 112 128.5 138Q168 164 202 275L455 1102Q465 1135 465 1153Q465 1245 322 1245L356 1356L1022 1356Q1300 1356 1415 1257.5Q1530 1159 1530 1011Q1530 902 1469.5 820.5Q1409 739 1305.5 692.5Q1202 646 1070 631Q1148 595 1225 363Q1281 196 1332.5 154Q1384 112 1466 112L1432 0L1035 0Q970 94 897 330Q854 469 822 523.5Q790 578 755.5 595Q721 612 642 612ZM675 720Q892 720 988 753Q1084 786 1137 869Q1190 952 1190 1042Q1190 1145 1118.5 1196.5Q1047 1248 904 1248Q889 1248 835 1245Z"/></g><g clip-path="url(#ww0c)"><g transform="translate(224.44444444444446 450) rotate(-2.127) scale(1.6269) translate(-247.20833333333334 -368)"><path transform="translate(200 450) scale(0.3 -0.3)" d="M155 269L251 609Q230 590 203.5 582Q177 574 151 574Q108 574 79 597Q50 620 50 663Q50 691 70 710.5Q90 730 121 730Q150 730 168.5 711.5Q187 693 187 662Q187 640 177 623Q177 617 189 617Q244 617 294 703L312 703L191 269Z" stroke="#fff" stroke-width="8.20" stroke-linejoin="round" stroke-linecap="round" paint-order="stroke"/></g></g></g></g><path transform="translate(209.63 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#fff" d="M736 1228Q736 1164 690 1118Q644 1072 580 1072Q516 1072 470 1118Q424 1164 424 1228Q424 1293 470 1338.5Q516 1384 580 1384Q644 1384 690 1338.5Q736 1293 736 1228ZM568 242L669 242Q541 -31 311 -31Q218 -31 171 8Q124 47 124 124Q124 169 163 282L283 627Q297 667 297 679Q297 691 291.5 696.5Q286 702 274 702Q223 702 154 572L58 572Q187 851 422 851Q505 851 551 810.5Q597 770 597 699Q597 647 556 534L440 218Q415 151 415 134Q415 123 421.5 117Q428 111 440 111Q466 111 506.5 156Q547 201 568 242Z"/><path transform="translate(303.67 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#fff" d="M61 0L412 1149Q422 1181 422 1199Q422 1252 297 1252L329 1356Q579 1356 686 1384L781 1384L516 515Q765 756 867 803.5Q969 851 1050 851Q1121 851 1166 821.5Q1211 792 1211 744Q1211 703 1181.5 672Q1152 641 1098 641Q1051 641 997 675Q964 696 934 696Q830 696 642 515Q723 515 791.5 476.5Q860 438 885 378Q910 318 920 194Q926 113 959 113Q1008 113 1084 255L1176 255Q1070 -14 822 -14Q739 -14 679 29Q619 72 619 155Q619 189 631 259Q642 328 642 354Q642 439 562 439L464 345L358 0Z"/><g transform="translate(562.05 0)"><g fill="#fff"><g clip-path="url(#ww4r)"><path transform="translate(200 450) scale(0.146484375 -0.146484375)" d="M642 612L545 294Q524 225 524 204Q524 112 687 112L653 0L-23 0L11 112L32 112Q89 112 128.5 138Q168 164 202 275L455 1102Q465 1135 465 1153Q465 1245 322 1245L356 1356L1022 1356Q1300 1356 1415 1257.5Q1530 1159 1530 1011Q1530 902 1469.5 820.5Q1409 739 1305.5 692.5Q1202 646 1070 631Q1148 595 1225 363Q1281 196 1332.5 154Q1384 112 1466 112L1432 0L1035 0Q970 94 897 330Q854 469 822 523.5Q790 578 755.5 595Q721 612 642 612ZM675 720Q892 720 988 753Q1084 786 1137 869Q1190 952 1190 1042Q1190 1145 1118.5 1196.5Q1047 1248 904 1248Q889 1248 835 1245Z"/></g><g clip-path="url(#ww4c)"><g transform="translate(224.44444444444446 450) rotate(-2.127) scale(1.6269) translate(-247.20833333333334 -368)"><path transform="translate(200 450) scale(0.3 -0.3)" d="M155 269L251 609Q230 590 203.5 582Q177 574 151 574Q108 574 79 597Q50 620 50 663Q50 691 70 710.5Q90 730 121 730Q150 730 168.5 711.5Q187 693 187 662Q187 640 177 623Q177 617 189 617Q244 617 294 703L312 703L191 269Z" stroke="#fff" stroke-width="8.20" stroke-linejoin="round" stroke-linecap="round" paint-order="stroke"/></g></g></g></g><path transform="translate(771.67 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#fff" d="M92 345Q92 450 153.5 570.5Q215 691 346.5 771Q478 851 659 851Q884 851 989.5 744Q1095 637 1095 485Q1095 276 933 122.5Q771 -31 519 -31Q336 -31 214 61.5Q92 154 92 345ZM385 244Q385 155 418.5 110.5Q452 66 519 66Q643 66 721.5 253Q800 440 800 569Q800 667 762.5 711Q725 755 676 755Q544 755 464.5 559Q385 363 385 244Z"/><path transform="translate(931.35 0) translate(200 450) scale(0.146484375 -0.146484375)" fill="#fff" d="M61 0L412 1149Q422 1181 422 1199Q422 1252 297 1252L329 1356Q579 1356 686 1384L781 1384L516 515Q765 756 867 803.5Q969 851 1050 851Q1121 851 1166 821.5Q1211 792 1211 744Q1211 703 1181.5 672Q1152 641 1098 641Q1051 641 997 675Q964 696 934 696Q830 696 642 515Q723 515 791.5 476.5Q860 438 885 378Q910 318 920 194Q926 113 959 113Q1008 113 1084 255L1176 255Q1070 -14 822 -14Q739 -14 679 29Q619 72 619 155Q619 189 631 259Q642 328 642 354Q642 439 562 439L464 345L358 0Z"/></g></svg>

package/bin/rikrok.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+// Rik Rok CLI. Your coding-agent sessions, recapped as reels you can doomscroll.
+const [major, minor] = process.versions.node.split(".").map(Number);
+if (major < 20 || (major === 20 && minor < 19)) {
+  console.error(`rikrok needs Node 20.19 or newer (you have ${process.versions.node})`);
+  process.exit(1);
+}
+
+const COMMANDS = {
+  setup: "Guided setup: local LLM, your voice, first reel, feed",
+  voice: "Your own voice: setup (record a clip) | test | devices | serve (local cloning server)",
+  watch: "Run the watcher: recap sessions as they go idle (foreground)",
+  hook: "Claude Code SessionEnd hook: install | uninstall (recap when you leave a session)",
+  recap: "Recap one transcript now (--transcript path)",
+  feed: "Serve the swipe feed",
+  backfill: "Recap the most recent qualifying sessions now (--limit N)",
+  doctor: "Check node, ffmpeg, sessions, LLM, voice, browser, port",
+  demo: "Render a demo reel from the bundled fixture session (--out path)",
+  install: "Install launchd agents for watch + feed on macOS (--uninstall to remove)",
+  config: "Print the settings in effect",
+};
+
+const [cmd, ...rest] = process.argv.slice(2);
+const args = parseArgs(rest);
+
+if (!cmd || cmd === "help" || cmd === "--help" || cmd === "-h") {
+  console.log(`rikrok <command> [options]\n`);
+  for (const [k, v] of Object.entries(COMMANDS)) console.log(`  ${k.padEnd(10)} ${v}`);
+  console.log(`\nSettings are RIKROK_* environment variables or ~/.rikrok/config.json (see README).`);
+  process.exit(0);
+}
+if (cmd === "version" || cmd === "--version" || cmd === "-v") {
+  const { PKG_VERSION } = await import("../src/lib/paths.mjs");
+  console.log(PKG_VERSION);
+  process.exit(0);
+}
+if (!COMMANDS[cmd]) {
+  console.error(`unknown command "${cmd}" (try: rikrok help)`);
+  process.exit(1);
+}
+
+const mod = await import(`../src/cli/${cmd}.mjs`);
+try {
+  const code = await mod.run(args);
+  if (typeof code === "number") process.exit(code);
+} catch (err) {
+  console.error(`rikrok ${cmd}: ${err.message}`);
+  process.exit(1);
+}
+
+function parseArgs(list) {
+  const out = { _: [] };
+  for (let i = 0; i < list.length; i++) {
+    const a = list[i];
+    if (a.startsWith("--")) {
+      const [k, v] = a.slice(2).split("=");
+      if (v !== undefined) out[k] = v;
+      else if (list[i + 1] !== undefined && !list[i + 1].startsWith("--")) out[k] = list[++i];
+      else out[k] = true;
+    } else out._.push(a);
+  }
+  return out;
+}

package/launchd/com.rikrok.plist.tmpl

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>{{LABEL}}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>{{NODE}}</string>
+    <string>{{BIN}}</string>
+    <string>{{CMD}}</string>
+  </array>
+  <key>WorkingDirectory</key><string>{{WORKDIR}}</string>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>ProcessType</key><string>Background</string>
+  <key>Nice</key><integer>10</integer>
+  <key>StandardOutPath</key><string>{{LOG}}</string>
+  <key>StandardErrorPath</key><string>{{ERRLOG}}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key><string>{{PATH}}</string>
+{{ENV}}
+  </dict>
+</dict>
+</plist>

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "rikrok",
+  "version": "0.5.0",
+  "description": "Your Claude Code sessions, recapped as short vertical reels you doomscroll on your phone. Local-first.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Alex Ferrao",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alexferrao/rikrok"
+  },
+  "homepage": "https://github.com/alexferrao/rikrok#readme",
+  "keywords": [
+    "claude-code",
+    "codex",
+    "coding-agent",
+    "recap",
+    "reels",
+    "remotion",
+    "local-first"
+  ],
+  "bin": {
+    "rikrok": "bin/rikrok.mjs"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "files": [
+    "bin",
+    "src",
+    "server",
+    "remotion",
+    "launchd",
+    "scripts",
+    "assets/icon.svg",
+    "assets/wordmark.svg",
+    "assets/wordmark.png",
+    "assets/readme",
+    "test/fixtures",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "watch": "node bin/rikrok.mjs watch",
+    "feed": "node bin/rikrok.mjs feed",
+    "backfill": "node bin/rikrok.mjs backfill",
+    "doctor": "node bin/rikrok.mjs doctor",
+    "demo": "node bin/rikrok.mjs demo",
+    "studio": "remotion studio remotion/index.ts",
+    "gen-icon": "node scripts/gen-icon.mjs",
+    "test": "node --test test/*.test.mjs"
+  },
+  "dependencies": {
+    "@fontsource-variable/bricolage-grotesque": "^5.2.5",
+    "@fontsource/ibm-plex-mono": "^5.2.5",
+    "@fontsource/spectral": "^5.2.5",
+    "@remotion/bundler": "4.0.399",
+    "@remotion/cli": "4.0.399",
+    "@remotion/renderer": "4.0.399",
+    "express": "^4.21.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "remotion": "4.0.399"
+  },
+  "devDependencies": {
+    "@fontsource/noto-music": "^5.3.0",
+    "fontkit": "^2.0.4",
+    "puppeteer-core": "^25.8.0"
+  }
+}