Release Notes

agentsmgr 1.0a13 (2026-08-15)

Enhancements

  • Eliminate the separate agentsmgr-maintain console script by folding its remaining contract into agentsmgr generate:

    agentsmgr generate (default mode)

    Renders distribution to distribution/ (or --output PATH). Supports --simulate and --check.

    agentsmgr generate --answers-file PATH --output PATH (answers-file)

    Uses the given Copier answers file as the configuration source and writes to the explicit --output target. Caller owns output allocation and cleanup; production CLI does not manage a temp directory.

    --answers-file requires --output. --check and --simulate are valid only in default mode (not with --answers-file).

  • Make renderers the authoritative source for distribution artifact file patterns, mirroring the renderer-owned directory contract from agentsmgr/18. Adds RendererBase.calculate_artifact_pattern(item_type) which returns the file glob pattern the renderer uses for artifacts of that type. Default is *.md; subclasses may override per renderer per item type for coders whose artifacts use a different file extension.

    Updates _detect_orphaned_artifacts to delegate to renderer.calculate_artifact_pattern(item_type) instead of hardcoding *.md. _copy_skills is intentionally not updated: skill files conform to the Skills protocol contract (source *.md rendered to destination SKILL.md), so the source glob pattern and the destination filename are coupled and remain protocol-owned. Future agentsmgr/11 skill-directory support may replace the flat-file scan with a skill-package abstraction.

    The contract returns a single glob expression. Renderers that need multiple file extensions or sets of patterns would need to widen the contract (e.g., to tuple[str, ...]); this is intentionally not done speculatively.

  • Migrate Copier template rendering validation to copiertv, configured via .auxiliary/configuration/copiertv/general.toml. The agentsmgr-maintain template subcommand is removed; agentsmgr-maintain now provides a single flat validate command (agentsmgr-maintain <variant>) which renders the distribution tree from components/ using a variant answers file from tests/data/profiles/ into an isolated temp directory.

  • Populate complete Agent Skills packages, including SKILL.md and supporting scripts, references, and binary assets. Preserve POSIX executable modes where the host filesystem supports them, and continue accepting legacy flat skill Markdown files.

Removals

  • Remove agentsmgr generate --variant and --preserve. Use agentsmgr generate --answers-file PATH --output PATH for explicit answers-file rendering; callers now provide the output location and lifecycle.

  • Remove the experimental validate-custom-slash command from the component sources and generated Claude Code and OpenCode distributions.

Repairs

  • Allow project-scoped Claude Code MCP servers to start in newly bootstrapped repositories by listing the emitted .mcp.json server names in enabledMcpjsonServers.

  • Stop coder-local .gitignore files from hiding Agentsmgr-managed commands, agents, skills, and OpenCode prompt resources. Agentsmgr records the specific distributed artifacts in the repository-local Git exclude file instead.

agentsmgr 1.0a12 (2026-07-07)

Enhancements

  • Changed generated Opencode command and agent resource directories to use the standard plural commands/ and agents/ names, while continuing to detect legacy singular distribution artifacts as stale output.

  • Restructured the managed agent distribution model around committed distribution/ artifacts generated from maintainer-owned components/ sources, with agentsmgr generate --check verification and agentsmgr populate consuming only the distribution tree.

Removals

  • Removed default Claude Code hook scripts and Opencode quality-assurance plugins from the Copier template so generated projects rely on tool-native diagnostics where available, agent guidance, and normal validation commands instead of blocking edit or shell-command integrations.

Repairs

  • Fixed agentsmgr source resolution for Windows absolute local paths, so drive-letter paths such as C:\\... are treated as filesystem paths rather than unsupported URL schemes.

agentsmgr 1.0a11 (2026-06-11)

Removals

  • Remove Gemini CLI support from Copier choices, renderer registration, template coder settings, and bundled default content/templates.

agentsmgr 1.0a10 (2026-04-02)

Enhancements

    • CLI: Add agentsmgr-maintain template survey and agentsmgr-maintain template validate <variant> commands for Copier template workflows, and move generated-content validation to agentsmgr-maintain content validate.

    • CI: Add .github/workflows/validate-template.yaml to exercise maintainer template/content validators across variant profiles.

Removals

    • Remove Qwen Code support from Copier choices, renderer registration, template coder settings, and bundled default content/templates.

agentsmgr 1.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.

agentsmgr 1.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.

agentsmgr 1.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.

agentsmgr 1.0a6 (2025-11-29)

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.

agentsmgr 1.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.

agentsmgr 1.0a4 (2025-10-25)

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.

agentsmgr 1.0a3 (2025-10-23)

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.

agentsmgr 1.0a2 (2025-10-22)

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.

agentsmgr 1.0a1 (2025-10-21)

Enhancements

  • CLI: Add –profile parameter to populate command for specifying alternative Copier answers file paths, enabling testing with different configurations.

  • CLI: Add –tag-prefix parameter to populate command for filtering Git version tags by prefix, with semantic version comparison for accurate tag selection.

  • CLI: Add support for Gemini CLI as a target coder for command generation (agent generation not supported by Gemini CLI).

  • CLI: Add support for Qwen Code as a target coder, including agent and command generation with YAML frontmatter templates and MCP server configuration.

  • Git: Automatically add generated symlink names to .git/info/exclude during populate command to prevent accidental commits of generated content.

  • Performance: Optimize GitHub and GitLab repository processing with API-based tag resolution and shallow cloning, providing 3-50x speedup for population operations.

Notices

  • CLI: Change populate command to use positional arguments for source and target instead of –source and –target flags. This is a breaking change for existing scripts.

  • CLI: Split command-line interface into user-facing (agentsmgr) and maintainer-facing (agentsmgr-maintain) tools. The validate command is now available via agentsmgr-maintain.

agentsmgr 1.0a0 (2025-10-12)

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.