v1.0a9

Executables

Linux

The Linux executables are dynamically linked and require a Glibc-based OS
distribution from 2022 or later (Ubuntu 22.04+, RHEL 9+, or derivatives). For
older Glibc-based OS distributions and non-Glibc-based OS distributions
(Alpine, etc...), please install the Python package instead.

Other Platforms

The macOS and Windows executables should work on any recent version of their
respective operating systems.

agentsmgr v1.0a9 (2026-03-03)

Repairs

• CLI: Fix Git source parsing and checkout behavior for explicit refs, SSH URLs,
  and malformed @ref or #subdir fragments with clearer validation errors.
• CLI: Support coders configured as either string lists or mapping entries
  when resolving per-user renderer settings.

v1.0a8

Executables

Linux

The Linux executables are dynamically linked and require a Glibc-based OS
distribution from 2022 or later (Ubuntu 22.04+, RHEL 9+, or derivatives). For
older Glibc-based OS distributions and non-Glibc-based OS distributions
(Alpine, etc...), please install the Python package instead.

Other Platforms

The macOS and Windows executables should work on any recent version of their
respective operating systems.

agentsmgr v1.0a8 (2026-02-04)

Enhancements

• Add an nb MCP server to the generated coder configurations.
• Add first-class Agent Skills (SKILL.md) generation for supported coders.
• Codex: Add a project rules allowlist (.codex/rules/) to permit common safe development commands outside the sandbox.
• Codex: Generate per-project configuration via .codex/config.toml by default (with CODEX_HOME support for per-user configs).
• Codex: Merge TOML configuration updates instead of overwriting, and create backups when rewriting may drop comments.

v1.0a7

Executables

Linux

The Linux executables are dynamically linked and require a Glibc-based OS
distribution from 2022 or later (Ubuntu 22.04+, RHEL 9+, or derivatives). For
older Glibc-based OS distributions and non-Glibc-based OS distributions
(Alpine, etc...), please install the Python package instead.

Other Platforms

The macOS and Windows executables should work on any recent version of their
respective operating systems.

agentsmgr v1.0a7 (2025-12-01)

Enhancements

• Added an 'openspec' symlink to the project root for easier access to architecture specifications.
• Improved the rendering of command result objects in the CLI, using bullet lists for clearer output.

v1.0a6

Executables

Linux

The Linux executables are dynamically linked and require a Glibc-based OS
distribution from 2022 or later (Ubuntu 22.04+, RHEL 9+, or derivatives). For
older Glibc-based OS distributions and non-Glibc-based OS distributions
(Alpine, etc...), please install the Python package instead.

Other Platforms

The macOS and Windows executables should work on any recent version of their
respective operating systems.

agentsmgr v1.0a6 (2025-11-30)

Enhancements

• Hooks: Add vulture dead code detection as blocking pre-commit check to ensure code quality before commits.
• Slash Commands: Improve release workflow reliability with extended timeouts and coder-agnostic backgrounded task handling guidance.

Repairs

• Hooks: Fix post-edit-linter hook to gracefully handle repositories without Hatch configuration.

v1.0a5

Executables

Linux

The Linux executables are dynamically linked and require a Glibc-based OS
distribution from 2022 or later (Ubuntu 22.04+, RHEL 9+, or derivatives). For
older Glibc-based OS distributions and non-Glibc-based OS distributions
(Alpine, etc...), please install the Python package instead.

Other Platforms

The macOS and Windows executables should work on any recent version of their
respective operating systems.

agentsmgr v1.0a5 (2025-10-28)

Enhancements

• CLI: Add claude-zai wrapper for GLM Coding Plan API integration, providing convenient access to glm-4.6 and glm-4.5-air models.
• OpenCode: Create opencode.jsonc symlink in per-project mode for proper configuration management and git exclusion.

Notices

• OpenCode: Disable built-in Pyright LSP server to prevent diagnostic errors and ensure proper type checking with project configuration.

v1.0a4

Executables

Linux

The Linux executables are dynamically linked and require a Glibc-based OS
distribution from 2022 or later (Ubuntu 22.04+, RHEL 9+, or derivatives). For
older Glibc-based OS distributions and non-Glibc-based OS distributions
(Alpine, etc...), please install the Python package instead.

Other Platforms

The macOS and Windows executables should work on any recent version of their
respective operating systems.

agentsmgr v1.0a4 (2025-10-26)

Enhancements

• CLI: Add source data structure validation to populate commands.
  The populate project and populate user commands now validate that the source location contains the required directory structure before attempting population.
  Invalid source structures produce clear error messages listing all missing required directories, allowing graceful failure instead of silently generating no items.
• CLI: Implement managed block for Git exclude entries.
  Git exclude entries are now managed within a clearly-marked, lexicographically sorted managed block with BEGIN/END markers.
  This ensures complete block replacement on each update, naturally handling entry removals and preventing accumulation of unnecessary blank lines.
• CLI: Implement mode-based filtering in populate commands.
  The populate project and populate user commands now filter coders by their default mode to ensure each command handles only appropriate coders: populate project processes per-project default coders, while populate user processes per-user default coders.
  Coder directory symlinks are now only created for coders whose default mode is per-project, preventing dangling symlinks for per-user coders.
• CLI: Split populate command into nested project and user subcommands.
  The populate command now uses a nested subcommand structure: populate project for project-scoped operations (content generation, symlinks, git exclude) and populate user for user-scoped operations (global settings, wrapper installation).
  The --mode flag has been removed, as populate project always uses per-project mode.
  The --update-globals flag has been replaced by the separate populate user subcommand.

v1.0a3

Executables

Linux

The Linux executables are dynamically linked and require a Glibc-based OS
distribution from 2022 or later (Ubuntu 22.04+, RHEL 9+, or derivatives). For
older Glibc-based OS distributions and non-Glibc-based OS distributions
(Alpine, etc...), please install the Python package instead.

Other Platforms

The macOS and Windows executables should work on any recent version of their
respective operating systems.

agentsmgr v1.0a3 (2025-10-24)

Enhancements

• Agent: Add python-annotator agent for Python type annotation tasks including adding type hints, resolving Pyright issues, creating type stubs, and analyzing type: ignore pragmas.
• CLI: Add instruction file downloading support to populate command with automatic retrieval from Git sources, flexible glob pattern filtering, and per-file preprocessing with header stripping support.
• CLI: Automatically manage git exclusion of instruction files through .git/info/exclude when populate command runs, respecting dynamic configuration changes.
• CLI: Populate command now skips items with missing content and logs warnings instead of failing the entire operation, enabling iterative development without complete content sets.

Repairs

• CLI: Fix template path resolution for OpenCode coder which was causing silent failures during content population due to singular/plural directory name mismatch.

v1.0a2

Executables

Linux

The Linux executables are dynamically linked and require a Glibc-based OS
distribution from 2022 or later (Ubuntu 22.04+, RHEL 9+, or derivatives). For
older Glibc-based OS distributions and non-Glibc-based OS distributions
(Alpine, etc...), please install the Python package instead.

Other Platforms

The macOS and Windows executables should work on any recent version of their
respective operating systems.

agentsmgr v1.0a2 (2025-10-23)

Enhancements

• Add support for Git worktrees and GIT_DIR environment variable in populate command, improving compatibility with non-standard Git configurations.
• Support relative paths in populate command source argument without requiring explicit ./ prefix. The source resolution now uses standard URL scheme extraction for simplified path handling.

Repairs

• Fix Git source handler URL scheme registration for correct path resolution in populate command source argument.
• Fix populate command to respect per-coder mode defaults when creating coder directory symlinks and properly handle interrupted operations for idempotent behavior.

v1.0a0

Executables

Linux

The Linux executables are dynamically linked and require a Glibc-based OS
distribution from 2022 or later (Ubuntu 22.04+, RHEL 9+, or derivatives). For
older Glibc-based OS distributions and non-Glibc-based OS distributions
(Alpine, etc...), please install the Python package instead.

Other Platforms

The macOS and Windows executables should work on any recent version of their
respective operating systems.

agentsmgr v1.0a0 (2025-10-13)

Enhancements

• CLI: Add Git ref specification support with @ref syntax for targeting specific branches, tags, or commits, with automatic latest tag fallback.
• CLI: Add Git source support with github:, gitlab:, and git+https: URL schemes for pulling agent configurations from remote repositories.
• CLI: Add agentsmgr command-line tool with detect, populate, and validate subcommands for managing AI agent configurations.
• CLI: Add automatic memory file symlink creation for coder-specific filenames (CLAUDE.md, AGENTS.md) pointing to shared project conventions.
• CLI: Add multi-target support with per-user and per-project targeting modes, including intelligent symlink management for seamless AI tool integration.
• Comprehensive slash command and agent configuration library for Python development, releases, architecture documentation, and project management.
• Hybrid distribution architecture combines Copier templates for base configuration with agentsmgr CLI for dynamic content generation from structured data sources.
• Multi-AI tool support for Claude Code, Opencode, and future AI development environments with extensible configuration management.
• Plugin architecture with extensible source handlers (git, local) and renderers (Claude, Opencode, Codex) using decorator-based registration system.
• Tag-based release system enables rapid configuration distribution using agents-N versioning scheme for atomic, consistent deployment.