agentslock 0.0.1

A package manager for agents/skills/MCPs across AI CLI tools

AGENTS.lock is a package manager for AI agent configurations. It keeps skills, agents, MCP servers, and instructions kept in sync across Claude, Codex, Gemini, and Copilot CLI tools. The lockfile is the single source of truth for both project and global scopes.

Install AGENTS.lock:

pip install agentslock

⚠️ Warning: This is an early release. Breaking changes may occur in future versions.

Usage:

al init          # Initialize a new AGENTS.lock file
al set clients claude,codex # Set CLI clients for the project
al add skill https://github.com/anthropics/skills/tree/main/skills/frontend-design # Add a skill
al sync          # Sync skills and agents as per the lockfile

This will make an entry in AGENTS.lock and sync the skill to the appropriate locations for the specified clients. From that point, it is not necessary to manually manage the skills across different clients, but simply maintain a single AGENTS.lock file and run al sync to keep everything up to date.

Currently supported clients and features:

Client	AGENTS.md	Skills	MCP
Claude	✓	✓	✓
Codex	✓	✓	✗
Copilot	✓	✓	✗
Gemini	✓	✓	✗

Lockfile basics

AGENTS.lock is a TOML file that records project metadata, default clients, and the full set of configured resources. Each entry carries a source, which can be a pinned git revision, a path relative to the lockfile, or inline content for instructions. Groups provide a way to filter subsets of resources during sync so teams can target specific workflows.

Install to project or global scope

Project scope writes within the repository. Global scope writes to user-level configuration paths.

al sync
al --global sync

Use lockfile aliases (alias file workflows)

If you manage multiple lockfiles, create an alias and target it via --lockfile.

al alias add work /path/to/AGENTS.lock
al --lockfile work sync