Skip to content

aliksir/memo-yoshi

Repository files navigation

MEMO-YOSHI 📝

日本語版はこちら

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 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

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:

- 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:

## 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

About

MEMO-YOSHI — Sticky notes for Claude Code. Write memos in Markdown, Claude reads, organizes, and acts on them.

Topics

Resources

License

Stars

1 star

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages