Repository navigation
Releases: ponycompute/gandalf
Release list
v0.11.0
Changelog
- 0a0355e docs(cli): describe every subcommand, argument, and flag in help
- 04ef6fd feat(cli): color and tidy skill output
- aab752b feat(distill): read Codex sessions, keep grouping stable, and record provenance
- 1ba826c feat(landing): make the page findable and shareable
- 3c6fb99 feat(skill): measure a skill's effect with gandalf skill test
- 8858fd1 feat(tui): open an inbox of skill drafts without the service
- 5f190eb feat(tui): show the selection, real filter counts, and key hints
- 8673b4d feat: distill sessions into lessons and draft skills from them
- cfe1f10 fix(cli): report the real cause of failures and make reports readable
- 012ed71 fix(landing): tell Vercel where the site is built
- d90d883 fix(skills): read and write the directories each agent actually uses
v0.10.0
Changelog
- f8c5afb feat!: focus Gandalf on skill management (#36)
- 8246a1d feat!: install with install.sh instead of Homebrew; v0.10.0 notes
- 0ea30cf feat!: rebuild Gandalf in Rust with skills and work handoff (#37)
- 3f6482c feat(landing): rebuild the landing page around skills and work handoff (#38)
- 34a7a8f fix(docs): exclude handoff plans from the GitHub Pages build
- 982a879 fix(landing): keep terminals from collapsing to two columns
v0.9.0
Changelog
- 4ea7a25 Reposition Gandalf as one config for multi-agent teams; add Team waitlist (#32)
- 1ac9c85 Switch Team plan signup to Tally and clarify early-access wording (#33)
- 2bde237 feat: first-run overview and plaintext secret detection (#34)
- 13ff4e5 fix: close remaining secret leaks; docs and v0.9.0 notes (#35)
v0.8.2
Changelog
- 0c77130 docs(release): add v0.8.2 release notes for selective skill profiles (boost)
- e8c90e8 feat(boost): implement core engine for selective skill injection and pruning
- c9d5484 feat(cli): add gandalf boost command and agent template generators
- 39554b8 feat(cli): make
gandalf exportthe primary local-env → toml command (#29) - f72dcef feat(manifest): support task profiles in schema, parser, and serializer
- 10f6a76 feat(sync): integrate profile integrity verification into project CI drift gate
- 3c5bc11 feat: make Cursor CLI a first-class Cursor surface (#26)
- cb59aed fix: align check --project-only with apply --project-only (#27)
v0.8.1 - Faster TUI Boot and Import Wizard Polish
v0.8.1 Release Notes
Release title: v0.8.1 - Faster TUI Boot and Import Wizard Polish
Summary
v0.8.1 is a patch on the v0.8.0 loop. gandalf tui now paints Changes-First Home in tens of milliseconds instead of more than a second, and the import wizard gets a responsive preview, overwrite confirmation, and UI polish.
Highlights
- Faster TUI boot: Home no longer captures current skill file bodies, walks Codex
~/.codex/plugins/cacheas skills, or waits on full snapshot JSON. One scan feeds baseline status; Timeline and Saves load after Home is ready. - Measured: full TUI boot replica on this machine (gandalf repo + real
~/.gandalf) went from 1.640s to 50ms. - Compatible drift: older snapshots that still contain plugin-cache skills do not show phantom removals. Installed Codex plugins from
config.tomlstill appear as drift. - Import wizard polish: responsive preview pane, overwrite confirmation modal, and tighter TUI layout for
gandalf import.
Release Validation
go test -count=1 ./...go vet ./...- GoReleaser multi-architecture darwin/linux binaries and Homebrew formula.
v0.8.0 - Import Wizard, Cursor, and CI Drift Gate
v0.8.0 Release Notes
Release title: v0.8.0 - Import Wizard, Cursor, and CI Drift Gate
Summary
v0.8.0 closes the Agent Environment as Code loop. Teams can reverse-generate gandalf.toml from existing Claude Code, Cursor, and Codex setups, catch project-level drift in GitHub Actions, and treat Cursor as a first-class supported agent alongside Claude Code and Codex.
Highlights
gandalf import: Reverse-engineers native agent configs (.mcp.json,.cursor/mcp.json, Codexconfig.toml, skill directories) into a canonicalgandalf.toml, with project-over-global precedence and atomic skill mirroring into.gandalf/skills/.- Secret templatization: Detected API keys, tokens, and connection strings are rewritten as
${ENV_VAR}and declared in[env_template]so credentials never land in git-tracked manifests. - Interactive import wizard: On a TTY,
gandalf importopens a Bubbletea TUI to group sources by agent, toggle servers/skills, preview a masked manifest, and confirm overwrite.--json,--dry-run, and piped I/O stay headless. - Safe CLI modes:
--project-only,--from <path>,--dry-run,--force, and--jsoncover automation and CI without writing unexpected files. gandalf-checkGitHub Action: Packaged CI drift gate that runs project-levelgandalf checkso pull requests can fail when agent environments diverge from the team manifest.- Cursor as a supported surface: Scan, check, apply, and restore now treat Cursor as a product-visible agent, not a compatibility leftover.
- Landing & monorepo: Turborepo + Bun workspaces for the Go CLI, Astro landing site, and Mintlify docs, with an authentic xterm.js manifesto terminal on the site.
Release Validation
go test -count=1 ./...go vet ./...- Opaque-box E2E suite
go test -count=1 ./test/e2e/import/...(Tiers 1–4) - Isolated smoke:
gandalf import --dry-run, overwrite guard, andgandalf check --project-only - GoReleaser multi-architecture darwin/linux binaries and Homebrew formula.
v0.7.0
Changelog
- 4ee94ef16cfbc8ea3ca4ba006a55fc251eb672de Updated mintlify pages
- 5c0ab37750ca191cb1d83157d48959beff052c97 Updated mintlify pages
- dc745a78936349dab94fdab4112cc0970d6eb79b Updated mintlify pages
- 5091eb19b59f8beb2e1136f7168060ae91ccbd71 Updated mintlify pages
- 73a87f5746444a490e24af86657ac952f1d2e663 Updated mintlify pages
- e561ef523ced780fa12c42d29a8f9af2d8920932 chore(landing): add vercel config and lockfile
- 4664ab6385a41ed7741fe862062057788d31132c docs(release): add v0.7.0 release notes for Agent Environment as Code
- 9031bad67f70e9c3dc3f1dee2d25bae835392652 feat(cli): add init, check, and apply commands for team manifest synchronization
- d48153bec0c3279427d85f486bfae62d282a5254 feat(landing): integrate full docs suite and update hero to Agent Environment as Code
- 559b22575eacc637e5d47e8bfb03db29afb5cfd0 feat(landing): integrate landing website into apps/landing
- 05ddfe979a96e05ff882c5352c7d050626b6f742 feat(landing): link official Mintlify docs (docs.usegandalf.com) in navigation and footer
- 910ddcd0365086657ce0f7fd6453cec88002f07e feat(manifest): add gandalf.toml parser, validator, and schema definitions
- fa3f5d64e1ff25903f652de1d8cbc2da0610dba6 feat(sync): add drift detection, non-destructive smart merger, and apply engine
- 1f77f10d5849becd0c49ff3afbf32a6c3477f7b7 style(landing): refine header and hero typography for compact layout
v0.6.0 - Trust-Visible TUI
v0.6.0 Release Notes
Release title: v0.6.0 - Trust-Visible TUI
Summary
v0.6.0 rebuilds Gandalf's terminal workspace around visible safety guarantees.
The TUI now has one consistent navigation grammar, exposes the actual mutation
capability of setup rows, and routes every write through the same Review
Changes boundary.
Highlights
- Five fixed destinations — Home, Console, Changes, Timeline, and Saves — are
reachable through a persistent responsive sidebar and global1–5keys. - A complete
?keymap, symmetric navigation, andesc-to-Home behavior
replace unreachable screens and case-sensitive jump shortcuts. - Console and Changes rows show provider-derived
[reviewable],
[restore-only], or[read-only]capability badges with concrete reasons. - Setup actions, MCP toggles, marketplace installs and rollback, saves, and
restore operations all require the unified Review Changes confirmation. - User-facing TUI copy consistently uses Save/Saves while preserving existing
CLI commands and on-disk snapshot compatibility. - Feedback now uses one frame-level status channel visible from every
destination. - Shared style tokens and responsive row rendering keep trust signals legible
on both wide and narrow terminals. - Dead Agent Detail, Compare, and standalone Save Setup render paths were
removed.
Release Validation
go test -count=1 ./...go vet ./..../scripts/gate2-console-acceptance.sh./scripts/changes-home-acceptance.sh./scripts/restore-safety-regression.sh./scripts/install-smoke.shgit diff --check- Go formatting check for
internal/tui. - GoReleaser configuration and release assets through GitHub Actions.
v0.5.1
v0.5.1 Release Notes
Release title: v0.5.1 - Safer Setup Actions and Changes-First Navigation
Summary
v0.5.1 strengthens the local control console's setup and recovery flows. It
removes flaky and cache-dependent verification paths, keeps Changes-first and
Environment navigation visible while scrolling, and adds the first concrete
provider-backed marketplace mutation for Claude Code.
Highlights
- Deterministic date handling for TUI tests and uncached verification gates.
- Changes-first Home acceptance coverage for baseline creation, drift review,
rollback, and narrow terminals. - Restore plans no longer report MCP removals separately when a content-backed
agent config restore already covers them. - Claude Code marketplace plugins can be previewed, revalidated from a fresh
scan, installed through the native provider, rescanned, and verified. - A verified Claude Code marketplace install can be rolled back with the exact
compensating provider command; unsupported update/uninstall paths remain
explicit rather than pretending to be available. - Environment Agents and Surfaces lists keep the selected row visible while
navigating through long lists.
Release Validation
go test -count=1 ./...make restore-safetymake gate2make changes-home./scripts/install-smoke.sh- GoReleaser configuration check through CI.
- GitHub release assets for darwin/linux amd64 and arm64 plus checksums.
v0.5.0
v0.5.0 Release Notes
Release title: v0.5.0 - Local Control Console and Reviewed Actions
Summary
v0.5.0 moves Gandalf from restore-first tooling toward the current product contract: a local control console for Codex and Claude Code user-global setup. It includes the recent setup-console work, aligns public product language, splits restore safety from Gate 2 setup-console acceptance, and adds the first marketplace-originated Review Action.
Highlights
- Compact setup browsing from PR #18.
- TUI control workspace from PR #19.
- Product contract alignment from PR #20.
- Gate 2 now means Unified Agent Setup Console acceptance.
- Restore safety remains covered by a separate restore-safety regression.
- Marketplace/source entries can start an honest non-mutating Review Action when provider metadata is sufficient.
Current Boundary
Supported product surface:
- Codex and Claude Code user-global setup.
- Installed inventory for skills, hooks, MCP servers, plugins, and agent-native marketplace/source entries.
- Review Changes before restore-backed applies or provider-backed setup actions.
- GitHub Releases,
install.sh, Homebrew, and source builds.
Still future or out of scope:
- Gandalf-owned marketplace/catalog/trust registry.
- Marketplace install, update, uninstall, add-source, or remove-source without a concrete provider-backed mutation path.
- Cursor, OpenCode, Pi Agent, project-local setup management, desktop launch, profiles, cloud sync, or team profiles as current product surfaces.
Release Validation Checklist
go test ./..../scripts/install-smoke.shmake restore-safetymake gate2- GoReleaser config check through CI.
- GitHub release assets for darwin/linux amd64/arm64 plus
checksums.txt. - Homebrew tap formula generated in
qyinm/homebrew-tap. - Latest
install.shpath resolves the v0.5.0 binary.
Public GitHub Metadata Target
- Description:
Local control console for AI agent setup. - Remove topic:
typescript - Candidate topics:
go,tui,cli,mcp,developer-tools,ai-agents,agent-tools,agent-management,drift-detection,security-audit
Release Operations
- Verify CI is green on the release branch.
- Update GitHub About/topics to the metadata target above.
- Ensure
GORELEASER_GITHUB_TOKENis configured with write access toqyinm/homebrew-tap. - Create and push tag
v0.5.0. - Verify the GitHub Release, binary assets, checksums,
install.shlatest resolution, and Homebrew tap formula.