KeyClaude

Engineering Personal Assistant

A personal productivity layer for engineers that uses keyboard shortcuts to trigger AI agents directly from the desktop. Agents perform scheduled tasks, weekly planning, and message rewriting — without breaking your flow.

---

Why KeyClaude

Engineers spend significant time on two things that shouldn't require much effort:

Writing. Slack messages, PR replies, doc comments — you write a draft, it's rough, and you either spend five minutes polishing it or send it rough. KeyClaude lets you select any text, hit a key, and get a rewritten version in your clipboard in seconds, from any app.

Context switching. Fetching relevant data before replying, pulling up last week's notes before a meeting, surfacing what matters before a 1:1 — each lookup is a small tax that compounds. KeyClaude agents do the fetch automatically, injecting context before you act.

---

Core Capabilities

Smart Message Rewriting

Keyboard shortcuts invoke agents to rewrite Slack messages with correct style and formatting. Writing insights surface inline so you improve over time — not just in this message.

Native Mac Shortcuts

Agent skills are bound to system-level shortcuts for low-friction access from any app. Select text, hit the key, get the result. No alt-tabbing, no copy-paste workflow.

Raycast Integration

Extensions expose agent skills as Raycast actions, composable with existing Raycast workflows. Use KeyClaude skills anywhere Raycast is already in your muscle memory.

Context-Aware Enrichment

Skills can fetch and inject relevant data from MCP servers (Glean, GitHub, Slack, and others) before sending. Your messages arrive with the right context already attached.

Scheduled Learning Sessions

Agents deliver scheduled lessons based on user-triggered sessions — coaching that adapts to your cadence and what you're actually working on.

Slide Deck Creator

Type /slides <topic> in your AI CLI to generate a complete reveal.js presentation. The skill writes a Markdown source file and builds a standalone HTML deck via pandoc. Includes a MongoDB-branded CSS theme; works with any reveal.js theme. Edit the Markdown and rebuild with the printed pandoc command.

---

Quick Start

3 Daily Actions

Action	When	How
Rewrite	Before sending anything important	Select text → ⌃⌥R (or copy → Raycast)
Later	Save a task from Slack or anywhere	Select text → ⌃⌥L (Slack thread link auto-detected from clipboard)
Capture	After a 1:1, review, or notable discussion	Select text → ⌃⌥G (or pbpaste | keyclaude-capture)

Weekly Actions

Action	When	How
Review backlog	Daily or end of week	keyclaude review backlog
Review work log	End of week	keyclaude review work-log
Weekly note	Monday create, Friday review	keyclaude-weekly-init / keyclaude-weekly-review

NOTE: Weekly review is an advanced feature. Start with Rewrite, Later, and Capture.

Install

# 1. Clone
git clone https://github.com/wtrocki/keyclaude.git
cd keyclaude

# 2. Run setup (config, macOS shortcuts, brew deps)
./install.sh

The bin scripts use opencode by default and fall back to Claude Code if opencode isn't found.

Alternatively, install globally via npm to get all commands on PATH:

npm install -g .
keyclaude install

Suggested key bindings:

Action	Key
Rewrite: Default	⌃⌥R
Rewrite: Leadership	⌃⌥P
Rewrite: External	⌃⌥E
Action: Later	⌃⌥L
Action: Capture	⌃⌥G

---

Skills

Skills are stateless — they transform input into structured output.

Skill	What it does
rewrite-inline	Rewrite text: default (internal comms), leadership (outcome-first), external (public-facing)
weekly-review	Synthesize a weekly note into five bullets: Focus, Cross-team Quality, Priority Shift, Priority Judgment, Mentorship Signal
capture	Log text as work evidence with optional AI analysis — saves raw input + analysis to work-log.md
monthly-review	Aggregate a period's weekly notes against the monthly plan into a snapshot: Impact Stories by North Star + LP tag, What Closed/Shipped, Major/Minor/Elective draft plan, backlog delta. Reads growth/leadership-principles.md + growth/signals.md as evaluation context — seed examples in examples/growth/
slides	Generate a reveal.js slide deck from a topic: /slides <topic> — outputs editable Markdown + standalone HTML

---

CLI

The keyclaude command manages installation, configuration, and review:

keyclaude install                # Run full setup
keyclaude config                 # Show current config
keyclaude config set KEYCLAUDE_DATA_REPO=/path/to/data   # Change data directory
keyclaude review backlog         # Open backlog in Plannotator
keyclaude review weekly          # Open current week in Plannotator
keyclaude review work-log        # Open work log in Plannotator

Individual commands are also available directly:

keyclaude-rewrite default        # Rewrite text
keyclaude-later                  # Save task to backlog
keyclaude-capture                # Log work evidence

Plannotator

KeyClaude integrates with Plannotator for browser-based annotation of your data files. Use it to review and annotate your backlog, weekly notes, and work log without leaving your flow.

# Review and annotate any data file:
keyclaude review backlog         # Annotate your task backlog
keyclaude review work-log        # Annotate your work evidence log
keyclaude review weekly          # Annotate current week's note
keyclaude review weekly 2026-W33 # Annotate a specific week
keyclaude review writing         # Annotate writing insights

# Or open any file directly:
plannotator annotate ~/Projects/engineering-notes/data/weekly/2026-W33.md

Config

All configuration lives in ~/.config/keyclaude/config. This file is sourced by every script — no env vars, no LaunchAgents, no .zshrc changes needed.

Key	Default	Purpose
KEYCLAUDE_DATA_REPO	$HOME/notes/data	Where weekly notes, growth logs, and later tasks are stored

# View:   keyclaude config
# Change: keyclaude config set KEYCLAUDE_DATA_REPO=/Users/you/wherever

The config file is a simple shell snippet — you can edit it directly: vim ~/.config/keyclaude/config

---

Architecture

Two-repo model

keyclaude is the engine: skills, agents, bin scripts, and shortcuts. No personal data lives here.

Your data directory ($KEYCLAUDE_DATA_REPO) is the data layer: weekly notes, leadership log, and work-specific context. The engine reads from it and writes back to it.

keyclaude/                    $KEYCLAUDE_DATA_REPO/
  bin/weekly-init      ──writes──▶   weekly/YYYY-WNN.md
  bin/weekly-review    ──reads ──▶   weekly/YYYY-WNN.md
                       ──writes──▶   weekly/YYYY-WNN.md (## Weekly Review appended)
  bin/rewrite          ──writes──▶   writing-insights.md
  bin/later            ──writes──▶   backlog.md
  bin/capture          ──writes──▶   work-log.md
  bin/monthly-review   ──reads ──▶   growth/*EDP*.md, growth/backlog.md, weekly/*.md
                       ──writes──▶   growth/reviews/YYYY-MM-DD.md

Bin Scripts

Script	Usage
bin/rewrite	echo "text" | bin/rewrite [default|leadership|external]
bin/later	echo "task text" | bin/later — appends to backlog.md with optional Slack thread link from clipboard
bin/capture	echo "text" | bin/capture — log as work evidence with timestamp and optional AI analysis
bin/weekly-init	bin/weekly-init [YYYY-WNN] — create a new weekly note
bin/weekly-review	bin/weekly-review [YYYY-WNN] — synthesize into five bullets
bin/monthly-review	bin/monthly-review [YYYY-MM-DD] — snapshot the period since the last cutoff into growth/reviews/<cutoff>.md

---

Status

This project is in active development. Planned work includes:

• Scheduled agent sessions (lesson delivery, weekly prompts)
• Deeper MCP integration for context enrichment (Glean, GitHub, Slack)
• Custom data source injection for domain-specific workflows
• Expanded Raycast extension surface

Contributions and feedback welcome.