{
  "markdown": "# MEMO-YOSHI 📝\n\n**[日本語版はこちら](README.ja.md)**\n\n> Claude Code への付箋。思いついたことを何でも書いておく場所。\n\n## What is this?\n\nA sticky note for Claude Code. Write memos in a Markdown file, and Claude reads, organizes, and acts on them. Works great with [neko-gundan](https://github.com/aliksir/neko-gundan) for multi-agent workflows.\n\n**The problem:** You think of something while Claude is processing, or while you're away from your desk. By the time you can tell Claude, you've forgotten.\n\n**The solution:** A Markdown file that's always open. Write anything — URLs, ideas, TODOs, complaints. Claude picks it up when you're ready.\n\n## Quick Start\n\n```bash\ngit clone https://github.com/aliksir/memo-yoshi.git\nbash memo-yoshi/install.sh\n```\n\nTwo files installed:\n- `~/.claude/MEMO-YOSHI.md` — your memo file\n- `~/.claude/commands/memo.md` — the Claude Code skill\n\n## Usage\n\n| Command | What it does |\n|---------|-------------|\n| `/memo` | Opens MEMO-YOSHI.md in your default editor |\n| `/memo read` | Reads memos into the current Claude session |\n| `/memo tidy` | Archives `終わりヨシッ！` items to `MEMO-YOSHI-archive.md`, organizes remaining into categories (URL, TODO, Ideas, Reference) |\n| `/memo add check Node version` | Appends a timestamped memo |\n| `/memo act` | Analyzes memos and takes action (opens URLs, runs checks, etc.) |\n| `/memo done` | Marks completed items with `終わりヨシッ！` (skipped by read/act) |\n\nAnything after `/memo` that isn't a subcommand is treated as a memo to add:\n\n```\n/memo remember to update the API docs\n/memo https://interesting-article.com/read-later\n/memo bug: login page breaks on Safari\n```\n\n## How `/memo act` works\n\nAct scans your memos and executes safe actions automatically:\n\n| Memo content | Action |\n|-------------|--------|\n| URL | Opens in browser |\n| \"check ...\" / \"confirm ...\" | Runs the check, writes result back |\n| \"research ...\" / \"look into ...\" | Searches the web, writes findings back |\n| \"fix ...\" / \"implement ...\" | **Does NOT auto-execute.** Asks for confirmation first |\n| File path | Checks if file exists, summarizes content |\n\nResults are written next to each memo with a timestamp:\n\n```markdown\n- https://example.com → ✅ Opened (2026-03-14 12:00)\n- check Node version → ✅ v22.5.0 (2026-03-14 12:01)\n- fix the login bug → ⏳ Recognized as request. Execute?\n```\n\n## Auto-read on session start (optional)\n\nIf you want Claude to automatically read your memos at the start of each session, add this to your CLAUDE.md or `/takeover` workflow:\n\n```markdown\n## Session Start\n- Read `~/.claude/MEMO-YOSHI.md` if it exists\n```\n\n## Tidy Archive\n\nWhen you run `/memo tidy`, completed items (`終わりヨシッ！` marked) are moved to `MEMO-YOSHI-archive.md` — a separate file in the same directory. Remaining items are organized into 4 categories:\n\n- **URL / Links** — memos containing URLs\n- **TODO / Requests** — action items (\"do X\", \"check Y\", etc.)\n- **Ideas / Notes** — free-form memos\n- **Reference** — knowledge items to keep but not act on\n\nThe archive file is date-grouped for easy browsing.\n\n## Rules\n\n- **Memos are never deleted.** `/memo tidy` moves completed items to an archive file and organizes the rest — nothing is lost.\n- **`/memo act` never runs destructive operations.** Implementation requests require your confirmation.\n- **`終わりヨシッ！` items are archived.** `/memo tidy` moves them to `MEMO-YOSHI-archive.md`. `/memo read` and `/memo act` skip them.\n- Works with any text editor. No special app needed.\n\n## Gotchas\n\n- **File search order**: Current directory `MEMO-YOSHI.md` takes priority over `~/.claude/MEMO-YOSHI.md`. If both exist, the current directory version is used.\n- **`/memo act` is safe**: It opens URLs and runs checks — never executes \"fix X\" or \"implement Y\" without your confirmation.\n- **`終わりヨシッ！` items are invisible**: They're skipped by `read` and `act`. To see them, explicitly ask \"show all including completed\".\n\n## Works with Claude Cowork too\n\nMEMO-YOSHI works in both Claude Code and Claude Cowork. In environments without Bash (like Cowork), browser launches and command execution are replaced with manual guidance — everything else (read, tidy, add, done) works the same.\n\n## Requirements\n\n- Claude Code or Claude Cowork\n- A text editor (you already have one)\n\n## License\n\nMIT\n",
  "bytes": 4240,
  "sha": "16e6a8eff945e7d737f5f70684e02aed1c75e5b7b5fc143f344d8fb2b535571f",
  "repo_slug": "aliksir/memo-yoshi",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_aliksir_memo_yoshi_memo_yoshi_6ddee021/readme"
}