memo-yoshi
Sticky notes for Claude Code. Write memos in a Markdown file — URLs, ideas, TODOs, anything. Claude reads, organizes by category, and acts o
Open source Open in the app JSON README (API)
About
Sticky notes for Claude Code. Write memos in a Markdown file — URLs, ideas, TODOs, anything. Claude reads, organizes by category, and acts on them (opens URLs, runs checks, marks done). No app needed, just a Markdown file + a skill definition.
Details
- Kind
- Plugins
- Topic
- Files & documents
- Publisher
- aliksir
- Origin
- marketplace
- Category
- ferramentas
- Stars
- 1
- Last push
- 2026-06-13T02:52:59Z
- Repository state
- ativo
- Language
- Shell
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
aliksir/memo-yoshi/memo-yoshi
README
# MEMO-YOSHI 📝
**[日本語版はこちら](README.ja.md)**
> Claude Code への付箋。思いついたことを何でも書いておく場所。
## What is this?
A 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.
**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.
**The solution:** A Markdown file that's always open. Write anything — URLs, ideas, TODOs, complaints. Claude picks it up when you're ready.
## Quick Start
```bash
git clone https://github.com/aliksir/memo-yoshi.git
bash memo-yoshi/install.sh
```
Two files installed:
- `~/.claude/MEMO-YOSHI.md` — your memo file
- `~/.claude/commands/memo.md` — the Claude Code skill
## Usage
| Command | What it does |
|---------|-------------|
| `/memo` | Opens MEMO-YOSHI.md in your default editor |
| `/memo read` | Reads memos into the current Claude session |
| `/memo tidy` | Archives `終わりヨシッ！` items to `MEMO-YOSHI-archive.md`, organizes remaining into categories (URL, TODO, Ideas, Reference) |
| `/memo add check Node version` | Appends a timestamped memo |
| `/memo act` | Analyzes memos and takes action (opens URLs, runs checks, etc.) |
| `/memo done` | Marks completed items with `終わりヨシッ！` (skipped by read/act) |
Anything after `/memo` that isn't a subcommand is treated as a memo to add:
```
/memo remember to update the API docs
/memo https://interesting-article.com/read-later
/memo bug: login page breaks on Safari
```
## How `/memo act` works
Act scans your memos and executes safe actions automatically:
| Memo content | Action |
|-------------|--------|
| URL | Opens in browser |
| "check ..." / "confirm ..." | Runs the check, writes result back |
| "research ..." / "look into ..." | Searches the web, writes findings back |
| "fix ..." / "implement ..." | **Does NOT auto-execute.** Asks for confirmation first |
| File path | Checks if file exists, summarizes content |
Results are written next to each memo with a timestamp:
```markdown
- https://example.com → ✅ Opened (2026-03-14 12:00)
- check Node version → ✅ v22.5.0 (2026-03-14 12:01)
- fix the login bug → ⏳ Recognized as request. Execute?
```
## Auto-read on session start (optional)
If you want Claude to automatically read your memos at the start of each session, add this to your CLAUDE.md or `/takeover` workflow:
```markdown
## Session Start
- Read `~/.claude/MEMO-YOSHI.md` if it exists
```
## Tidy Archive
When 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:
- **URL / Links** — memos containing URLs
- **TODO / Requests** — action items ("do X", "check Y", etc.)
- **Ideas / Notes** — free-form memos
- **Reference** — knowledge items to keep but not act on
The archive file is date-grouped for easy browsing.
## Rules
- **Memos are never deleted.** `/memo tidy` moves completed items to an archive file and organizes the rest — nothing is lost.
- **`/memo act` never runs destructive operations.** Implementation requests require your confirmation.
- **`終わりヨシッ！` items are archived.** `/memo tidy` moves them to `MEMO-YOSHI-archive.md`. `/memo read` and `/memo act` skip them.
- Works with any text editor. No special app needed.
## Gotchas
- **File search order**: Current directory `MEMO-YOSHI.md` takes priority over `~/.claude/MEMO-YOSHI.md`. If both exist, the current directory version is used.
- **`/memo act` is safe**: It opens URLs and runs checks — never executes "fix X" or "implement Y" without your confirmation.
- **`終わりヨシッ！` items are invisible**: They're skipped by `read` and `act`. To see them, explicitly ask "show all including completed".
## Works with Claude Cowork too
MEMO-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.
## Requirements
- Claude Code or Claude Cowork
- A text editor (you already have one)
## License
MIT