{"id":46295436,"url":"https://github.com/reubenjohn/reeve-desk","last_synced_at":"2026-03-04T09:32:08.733Z","repository":{"id":334337788,"uuid":"1141024436","full_name":"reubenjohn/reeve-desk","owner":"reubenjohn","description":"A proactive AI Chief of Staff workspace template - transparent, editable Markdown files for Goals, Responsibilities, Preferences, and memory","archived":false,"fork":false,"pushed_at":"2026-02-17T19:05:48.000Z","size":216,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-02-18T00:42:22.242Z","etag":null,"topics":["ai-agent","ai-assistant","chief-of-staff","claude-code","knowledge-management","markdown","personal-productivity","proactive-ai","template-repository"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/reubenjohn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-24T05:22:34.000Z","updated_at":"2026-02-17T19:05:52.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/reubenjohn/reeve-desk","commit_stats":null,"previous_names":["reubenjohn/reeve-desk"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/reubenjohn/reeve-desk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenjohn%2Freeve-desk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenjohn%2Freeve-desk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenjohn%2Freeve-desk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenjohn%2Freeve-desk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/reubenjohn","download_url":"https://codeload.github.com/reubenjohn/reeve-desk/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/reubenjohn%2Freeve-desk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30077078,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T08:01:56.766Z","status":"ssl_error","status_checked_at":"2026-03-04T08:00:42.919Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agent","ai-assistant","chief-of-staff","claude-code","knowledge-management","markdown","personal-productivity","proactive-ai","template-repository"],"created_at":"2026-03-04T09:32:07.977Z","updated_at":"2026-03-04T09:32:08.723Z","avatar_url":"https://github.com/reubenjohn.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Reeve Desk\n\nWelcome to your **Reeve Desk** - the transparent, editable workspace where Reeve (your AI Chief of Staff) stores all knowledge about you.\n\n## What is the Desk?\n\nThe Desk is a collaborative workspace between you and Reeve. Everything Reeve knows about you lives here in plain Markdown files. There are no hidden databases, no black-box algorithms - just transparent, human-readable text files you can edit anytime.\n\n## Directory Structure\n\n```\nreeve_desk/\n├── README.md              ← You are here\n├── CLAUDE.md              ← Reeve's identity \u0026 operating instructions\n├── .claude/skills/        ← Reeve's workflow skills (invocable with /skill-name)\n│\n├── Goals/                 ← Your North Star (long-term objectives)\n├── Responsibilities/      ← Your Operational Manual (recurring duties)\n├── Preferences/           ← Your User Manual (how you want Reeve to behave)\n├── Tasks/                 ← Discrete action items with deadlines\n│\n└── Knowledge/             ← Everything Reeve \"knows\"\n    ├── Diary/             ← Activity logs, patterns, investigations\n    │   ├── YYYY-MM/       ← Monthly folders for daily logs\n    │   ├── Investigations/ ← Deep-dive research sessions\n    │   ├── Patterns/      ← Recurring behavioral patterns\n    │   └── Archive/       ← Old monthly roll-ups\n    ├── Infrastructure/    ← MCP servers, health checks, runbooks\n    │   └── Runbooks/      ← Per-service troubleshooting guides\n    └── Relationships/     ← People, contacts, interaction tracking\n```\n\n## Quick Start\n\n### 1. Understand How Reeve Works\n\nRead these files to understand Reeve's operating model:\n\n1. **[CLAUDE.md](CLAUDE.md)** - Reeve's core identity, decision-making framework, and pulse workflow\n2. **`.claude/skills/`** - Reeve's workflow skills (auto-invoked or manual with `/skill-name`)\n   - `/morning-briefing` - Daily morning briefing at 8 AM\n   - `/evening-wrapup` - Daily evening wrap-up at 6 PM\n   - `/emergency-response` - Handle critical/urgent events\n   - `/schedule-followup-pulse` - Schedule follow-up pulses\n   - `/goal-check` - Weekly goal review (manual-only)\n   - `/diary-log` - Log activities to Diary\n\n### 2. Tell Reeve About Yourself\n\nFill in these template files with your information:\n\n1. **[Goals/Goals.md](Goals/Goals.md)** - What are you trying to achieve? (3-5 major objectives)\n2. **[Responsibilities/Responsibilities.md](Responsibilities/Responsibilities.md)** - What recurring duties do you have?\n3. **[Preferences/Preferences.md](Preferences/Preferences.md)** - How should Reeve communicate with you?\n\n### 3. Start Using Reeve\n\nOnce you've personalized the Desk:\n\n1. **Ensure reeve-bot is configured** to point to this directory (default: `~/reeve_desk`)\n2. **Complete reeve-bot Phase 5+** (Daemon, API, integrations)\n3. **Test the integration** by scheduling a test pulse\n4. **Iterate** - adjust files based on how Reeve behaves\n\n## Key Principles\n\n### 1. The \"Glass Box\" - Complete Transparency\n\n**Traditional AI assistants are \"black boxes\"** - you don't know why they make decisions.\n\n**Reeve is a \"glass box\"** - every preference, every goal, every decision rationale is visible in plaintext files you can edit.\n\n**Example:**\n```\nWhy did Reeve decline that 8 AM meeting?\n→ Check Preferences/Preferences.md: \"No meetings before 9 AM\"\n→ Don't like that rule? Edit the file or delete the line.\n```\n\n### 2. The \"Push\" Paradigm - Proactive, Not Reactive\n\n**Traditional assistants wait for you to ask.**\n\n**Reeve anticipates needs and initiates conversations:**\n- Checks flight status before your departure and notifies you of delays\n- Notices you haven't exercised in 5 days and suggests a workout\n- Sees a snowstorm coming to your favorite ski resort and proposes a trip\n\n**How it works:**\n- Reeve wakes up on three types of pulses:\n  - **Periodic pulses** (automatic, every hour on the hour)\n  - **Aperiodic pulses** (Reeve schedules these for non-hour times using `schedule_pulse()`)\n  - **Event-triggered pulses** (external events like Telegram messages)\n- When a pulse fires, Reeve reads the Desk and takes action\n- You're only interrupted when something truly requires your attention\n\nFor the full pulse workflow, see [CLAUDE.md](CLAUDE.md) § Workflow for Each Pulse.\n\n### 3. Edit Anything, Anytime\n\n**This is YOUR workspace.** Feel free to:\n- Edit any file to change Reeve's behavior\n- Reorganize directories\n- Delete sections that don't apply\n- Add new files for specialized preferences\n- Evolve the structure over time\n\n**Reeve will adapt to whatever you create.**\n\n## What to Edit First\n\n### For Minimal Setup (10 minutes):\n\n1. **Goals/Goals.md** - Add 1-3 current goals (examples provided)\n2. **Preferences/Preferences.md** - Set notification times and DND hours\n3. **Responsibilities/Responsibilities.md** - Add morning/evening routines\n\n### For Full Setup (30-60 minutes):\n\n- Complete all sections in Goals, Responsibilities, and Preferences\n- Add detailed communication rules and calendar preferences\n- Define priority frameworks\n\n## How Reeve Uses the Desk\n\nEach time Reeve wakes up on a pulse, it reads your Goals, Responsibilities, Preferences, and recent Diary entries to understand your context — then takes action (notifications, scheduling, logging). For the detailed workflow, see [CLAUDE.md](CLAUDE.md) § Workflow for Each Pulse.\n\n## Troubleshooting\n\n### Reeve Isn't Behaving As Expected\n\n1. **Check CLAUDE.md** - Does it define the behavior you want?\n2. **Check Preferences/Preferences.md** - Is there a rule causing this?\n3. **Read Knowledge/Diary/** - Look at recent logs to understand reasoning\n4. **Check Knowledge/Infrastructure/** - Is an MCP server down?\n5. **Edit the relevant file** to change the behavior\n\n### Infrastructure Issues\n\nSee [Knowledge/Infrastructure/README.md](Knowledge/Infrastructure/README.md) for MCP health checks and per-service runbooks.\n\n## File Editing Tips\n\nAll Desk files use standard Markdown. Edit with any text editor — Reeve reads them directly from the filesystem.\n\n### Version Control\n\nChanges are tracked with git automatically by Reeve. You can also commit manually:\n\n```bash\ncd ~/reeve_desk\ngit add .\ngit commit -m \"Updated preferences: added DND hours\"\n```\n\n## Privacy \u0026 Security\n\n### What's Stored Here\n\n- Your goals and priorities (plaintext)\n- Your preferences (plaintext)\n- Reeve's activity logs (plaintext)\n\n**NOT stored here:**\n- Passwords or API keys (those go in `.env` files in reeve-bot/)\n- Sensitive data (you control what goes in these files)\n\n### Who Can Access This\n\n- **You** - Full read/write access\n- **Reeve** - Read/write access (for Knowledge/Diary/, Tasks/)\n- **Anyone with filesystem access** - These are plaintext files\n\n## Further Reading\n\n- **[CLAUDE.md](CLAUDE.md)** - Deep dive into Reeve's operating principles\n- **[Knowledge/README.md](Knowledge/README.md)** - Index of all knowledge (Diary, Infrastructure, Relationships)\n- **[Knowledge/Diary/README.md](Knowledge/Diary/README.md)** - How Reeve's memory system works\n- **[Preferences/Preferences.md](Preferences/Preferences.md)** - Example preferences with detailed explanations\n\n---\n\n**Created:** 2026-01-20\n**Updated:** 2026-02-17\n**Version:** 2.0\n**Maintainer:** You (the user)\n\nRemember: This is YOUR workspace. Shape it however makes sense to you. Reeve will adapt.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freubenjohn%2Freeve-desk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Freubenjohn%2Freeve-desk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Freubenjohn%2Freeve-desk/lists"}