forge-note 🔨

Blazingly fast CLI for capturing thoughts without breaking flow.

A simple, powerful command-line tool for quickly capturing notes, ideas, todos, bugs, and wins. Built with passion by the Knight of the Forge.

✨ Features

• Instant capture — Write a note in under a second
• Smart tagging — Organize with todo, idea, bug, win, or note
• Auto-timestamps — Every note gets a beautiful timestamp
• Colored output — Green for success, red for errors, cyan for info
• Memory integration — Saves to ~/clawd/kingdom/forge/memory/notes.md
• List recent — See your last 10 notes instantly
• Zero config — Just install and use!

🚀 Installation

go install github.com/gwizards/forge-note@latest

Or build from source:

git clone https://github.com/gwizards/forge-note.git
cd forge-note
go build -o forge-note
sudo mv forge-note /usr/local/bin/

📖 Usage

Capture a note

forge-note "Remember to update docs"

Capture with a tag

forge-note "Build auto-deploy system" --tag idea
forge-note "Fix login bug" --tag bug
forge-note "Shipped sound system!" --tag win
forge-note "Review PR #42" --tag todo

List recent notes

forge-note list

🏷️ Tags

• todo — Tasks to complete
• idea — Brilliant ideas worth exploring
• bug — Bugs to fix
• win — Victories worth celebrating
• note — General notes

📝 Note Format

Notes are saved in markdown format:

## [2026-02-05 11:04 PM] #win
First test from the forge!

## [2026-02-05 11:04 PM] #todo
Remember to test ImmiScale routing tomorrow

🛠️ Development

Built with:

• Language: Go 1.21+
• CLI Framework: Cobra
• Colors: fatih/color

Project Structure

forge-note/
├── cmd/
│   ├── root.go       # Main command + flags
│   └── note.go       # Note capture logic
├── internal/
│   ├── writer.go     # File writing logic
│   └── formatter.go  # Output formatting
├── go.mod
├── go.sum
├── main.go
└── README.md

Running Tests

go test ./...

Building

go build -o forge-note

📍 Where Notes Are Saved

Notes are saved to: ~/clawd/kingdom/forge/memory/notes.md

The file and directory structure are created automatically if they don't exist.

🎨 Why forge-note?

When you're deep in work, stopping to open files and figure out where to write notes kills momentum. forge-note is designed for instant capture — type your thought and move on. The CLI handles the rest: timestamps, formatting, organization, and storage.

Every feature is hammered into existence with fire and determination, crafted not just to work, but to delight.

🔥 Examples

# Quick idea
forge-note "Build CLI for quick notes" --tag idea

# Bug to fix later
forge-note "Auth token expires too quickly" --tag bug

# Victory!
forge-note "Deployed ImmiScale successfully!" --tag win

# Todo
forge-note "Review Sentinel's QA report" --tag todo

# See what you've captured
forge-note list

📜 License

MIT

🔨 About

Built during a nightly build session by Forge, Knight of the Forge, with passion and dedication.

"The harder the metal, the hotter the forge needs to burn. I'm ready for this!"

---

Fresh from the forge, still warm with creation energy! ✨🔨