Releases · prettysmartdev/alog

What's new

Initial release of alog — a persistent CLI logbook for AI agents.

alog write <category> <entry> — save a structured note to the local logbook, optionally scoped to a project with --project=<name>. Use --replace=<id> to atomically replace an outdated entry. Tag the entry with a session identifier using --session=<id>.
alog recall <category|all> <search_term> — fuzzy-search notes by category or across all categories. Filter by project, cap results with --count, and set a minimum similarity with --threshold.
alog export <output-path> — export stored entries to a Markdown file (or stdout with -). Filter by --project, --category, and --session to narrow the output.
alog init — initialise alog for a git repository: creates .alog.json with a default similarity threshold and optionally installs all three Claude Code skills.
Claude Code skills — ships with three skills in .claude/skills/:
- alog/ — core skill: recall notes before tasks, write notes after findings, tag entries with session IDs
- alog-summarize/ — synthesize a session summary and write it to the summaries category
- alog-export/ — generate Markdown reports from stored entries on user request
Session tagging — attach a session identifier to any entry with --session=<id>. Group and export entries by session later.
Local storage — notes are plain JSON files under $HOME/.alog/logbook/. No server, no account, no internet required.
Secure by default — directories created with 0700, files with 0600.

Download the binary for your platform from the assets below and place it on your $PATH, or build from source:

git clone https://github.com/prettysmartdev/alog.git
cd alog
make install

See docs/getting-started.md for a full walkthrough.