Huza Notes

Your project memory — always there, always ready.
One VSIX. Zero setup. Works on any machine.

Why? · What You Get · See It · Install · FAQ

Why Huza Notes?

Because context shouldn't disappear when you close a terminal.

Every developer knows the pain: you're deep in a coding session, switch contexts, and lose the thread. What were you working on? What decisions did you make? What changed?

Huza Notes fixes that. It's a project memory layer that:

• 📓 Auto-logs every file change — timestamps, categories, relative paths
• 🧠 Remembers what you did — session start/end, decisions, plan changes
• 🚀 Gives you opencode instantly — with custom branding, on any PC
• 🔌 Needs nothing else — one VSIX, zero dependencies, works offline

"Installed it on a fresh Windows laptop. Extension detected opencode was missing, installed it, and within 30 seconds I was in my flow."

What You Get

🧠 Persistent Project Journal

Every save is timestamped and categorized automatically:

## Session 2026-06-04
- Status update (09:00): Session started
- File change (09:05): script src/components/App.js
- Decision (09:15): Using Zustand for state management
- Status update (11:30): Session ended (duration: 150 min)

• Append-only — never deletes or overwrites
• Plain Markdown — open it, edit it, commit it to git
• Work everywhere — works with or without a workspace folder
• Live dashboard — Activity Bar panel shows sessions, entries, categories, last activity

🚀 One-Click opencode Terminal

Opencode is the most powerful AI coding terminal out there. Huza Notes gives it to you instantly — no configuration, no separate install:

🔄 Auto-Install (Zero Touch)

You never have to do anything. Install the VSIX on any machine — even one that has never seen Node.js:

1. Install the VSIX
2. Open VS Code
3. Press Ctrl+Shift+Esc

That's it. The extension handles everything silently behind the scenes:

No terminal commands. No Googling. No "command not found" errors. No buttons to click.

🎨 Huzaflix Branding

The opencode terminal shows the Huzaflix Code wordmark — "Huza" in brand green, "flix Code" in the terminal text color. It's a small touch that makes the experience feel yours.

See It in Action

(Screenshots coming soon — install and see for yourself!)

Install

The 10-Second Install

code --install-extension huza-notes-1.4.0.vsix

That's it. Reload VS Code (Ctrl+Shift+P → Developer: Reload Window).

What happens next

All 3 strategies run automatically. You never touch a terminal.

System Requirements

• VS Code 1.80.0 or later
• Node.js (recommended, but not required — extension works without it, just can't auto-install opencode)
• Works on: Windows, macOS, Linux

Download

Grab the latest .vsix from the releases page (or build from source — see Development).

FAQ

Q: Do I need the official opencode extension too?
A: No. Huza Notes is fully self-contained. It replaces the official sst-dev.opencode extension entirely — creates the terminal, manages branding, handles everything. One VSIX is all you need.

Q: What if I already have opencode installed?
A: Extension detects it instantly and skips the install. No duplicate installs, no conflicts.

Q: What if the PC has no Node.js at all?
A: The extension shows a friendly dialog: "Node.js/npm is not installed" with a Download Node.js button. Click it, install Node.js (2 minutes), come back, and Huza Notes handles the rest.

Q: Where is my journal stored?
A: In your project at .opencode/memory/journal.md. If no project is open, it falls back to ~/.local/share/opencode/memory/journal.md. Plain text. You own it.

Q: Is my data sent anywhere?
A: Never. Everything is local. No telemetry, no servers, no data collection.

Q: Can I edit the journal manually?
A: Yes. It's plain Markdown. The Activity Bar panel refreshes automatically when you save.

Q: What about multiple workspaces?
A: Each workspace folder gets its own .opencode/memory/journal.md. The panel switches automatically.

Q: Does it work on macOS and Linux?
A: Yes. The auto-install uses which opencode / which npm on Unix systems — same seamless experience.

Development

git clone https://gitlab.com/didierkibugenza/memory-agent-vscode.git
cd memory-agent-vscode
npm install
npm run package          # builds .vsix

To run in development mode, open the folder in VS Code and press F5.

Project structure

memory-agent-vscode/
├── extension.js     # All extension code (fully self-contained)
├── package.json     # Manifest, commands, keybindings
├── images/          # Icons (green Huza "H" mark)
├── CHANGELOG.md
├── LICENSE
└── README.md        # You are here

Commands Reference

License

MIT — see LICENSE.

_{Made by Huzalabs · One VSIX to rule them all}