Releases: snvtac/ago-cli
v0.1.2
ago-cli v0.1.2
Self-use enhancements for the launcher: pin your everyday projects and resume a specific past session.
Features
- Project pinning —
ago pin [name]/ago unpin [name]. Pinned projects sort to the top of the list with a★marker.[name]resolves by current directory (no arg), directory path, or unique fuzzy name. Pins are stored in~/.ago/state.json;config.jsonstays hand-edited and is never written byago. - Historical session picker — when a tool has ≥2 recorded sessions for a project, the CLI menu offers “选择历史会话…” to pick and resume a specific past session. Codex sessions come from the existing scan; Claude sessions are scanned lazily from the project's transcript directory with a first-message preview. “← 返回” returns to the tool menu.
ago doctornow reportsstate.pinnedCountand a warning-onlystate.pinned_paths_existcheck when a pinned path no longer exists (does not affect the exit code; reportformatVersionstays1.0).
Fixes
ago unpincan remove a pin whose directory no longer exists — it matches the stored pins directly instead of requiring the path to exist on disk.- Claude session previews skip slash-command boilerplate (
<local-command-caveat>/<local-command-stdout>) and surface the<command-name>instead, eliminating noise previews.
No new runtime dependencies. Read-only commands remain read-only. Node >= 18.
v0.1.1
Add two read-only diagnostic commands.
Highlights
ago doctor— JSON health report covering runtime, config, state, commands, history sources, and the project index. Read-only (never writes config/state); exits non-zero only when a check is anerror(warnings keep exit 0).ago config show— prints the normalized config with each key'ssource(fileordefault). Missing config → defaults, exit 0; invalid JSON →validJson: false, exit non-zero.
Both output JSON only; no --fix or text mode in v1. The existing interactive flow and -a/-n/-c/-l / ago - are unchanged.
v0.1.0
ago-cli v0.1.0 🎉
Still built for developers with goldfish memory 🐟🧠 — and now it actually remembers your Claude side too.
🔴 Big fix: your Claude history is back
Recent Claude Code stopped writing sessions-index.json, so ago was silently dropping every Claude project and only showing Codex. It now reads ~/.claude/history.jsonl + the newest transcript per project (for the true cwd), with the old index kept as a legacy fallback — paths are taken from real cwd/project fields, never decoded from directory names. On a real machine this went from 0 → 21 Claude-backed projects. 🚑
✨ What's new
- 📈 frecency ranking — projects sort by frequency × recency, so your daily repos stay on top instead of whatever you touched once yesterday.
- ⚡
ago -(aliasago --last) — instantly reopen the last project + CLI you launched, zero menus. Graceful fallback to the list if the path/CLI is gone. - 🔁 Continue last session — the CLI menu now offers "continue last session", resuming the exact session id (
claude --resume <id>/codex resume <id>).
🧰 Under the hood
- Codex/Claude observations now carry their
sessionId. - Robust epoch parsing (millisecond and second timestamps).
- Three-source Claude collection deduplicated by session id.
lastLaunchpersisted in~/.ago/state.json.- Test suite grew 20 → 38, zero new runtime dependencies.
Grab it: npm i -g ago-cli or npx ago-cli 🚀
v0.0.5
ago-cli v0.0.5 🎉
Built for developers with goldfish memory 🐟🧠
- New
-c: pass initial content directly intocodex/claude✨ ago -n project_name -c "content....": finds the project, then launches straight into context 🚀- Single match still fast-tracks you past the project list ✅
- Multiple matches still let you pick the project first, then pick CLI (
codexorclaude) ⚡ - No match? same behavior as before, nice and predictable 👻
Under the hood: added tests and docs for the new -c launch flow, and bumped version to 0.0.5.
v0.0.4
ago-cli v0.0.4 🎉
Built for developers with goldfish memory 🐟🧠
- Finds projects from your local
codex/claudehistory ago: shows onlyexistsprojects ✅ago -al: shows everything, includingmissingghosts 👻-n: fuzzy search; if one match, it fast-tracks you to launch 🚀- Pick project, then pick CLI (
codexorclaude), and go ⚡
Under the hood: migrated to TypeScript, publish dist-only package, Node >=18.