0.2.1

PyPI

agentcfg

CLI tool for deploying and managing AI coding agent configurations (MCP servers, skills, instructions) across multiple providers.

Published8 May 2026

Direct dependencies0

Transitive dependenciesNot calculated

README

Version 0.2.1 documentation

agent-config

A Python CLI tool for deploying and managing AI coding agent configurations — MCP servers, instruction files (AGENTS.md, CLAUDE.md), skills, and runtime memory — across multiple providers and machines.

Keep your configs in version control. Run agent-config deploy to push them to every tool.

Install

pip install agentcfg

Or with uv:

uv tool install agentcfg

Quick Start

# Scaffold a new config directory
agent-config init

# Edit the generated files to match your setup
# (mcp_providers.json, agents.json, instruction_providers.json …)

# Deploy everything
agent-config deploy

Commands

Command	Description
`agent-config init`	Scaffold a new config repo with starter templates
`agent-config deploy`	Deploy manifest entries (files/dirs) to their destinations
`agent-config pull`	Pull memory files back from deployed locations into the repo
`agent-config sync`	Deploy then run `agents sync` across all LLM providers
`agent-config mcp deploy`	Write MCP server configs to all registered provider files
`agent-config mcp sync`	Additive MCP sync — add only servers missing from disk
`agent-config mcp show`	Show MCP configuration status per provider
`agent-config instructions deploy`	Copy instruction files (AGENTS.md etc.) to each provider
`agent-config instructions show`	Show instruction file status per provider
`agent-config skills deploy`	Deploy all registered skills to their target agents
`agent-config skills sync`	Deploy only skills not yet installed
`agent-config skills show`	Show skill deployment status
`agent-config providers list`	List registered MCP providers
`agent-config providers add`	Add a new MCP provider to the registry
`agent-config providers remove`	Remove an MCP provider
`agent-config providers set-path`	Update a provider's config file path

Global options

Flag	Description
`--config-dir DIR` / `-C DIR`	Root of your config repo (default: cwd or `$AGENT_CONFIG_DIR`)
`--version` / `-V`	Print version and exit

Filtering and dry-run

Most commands accept --providers p1 p2 … to limit to specific providers, and --dry-run to preview changes without writing anything.

Config Files

File	Purpose
`manifest.json`	Maps source files/dirs to their deploy destinations
`agents.json`	MCP server definitions and integration toggles
`mcp_providers.json`	Registry of MCP provider config paths and formats
`instruction_providers.json`	Registry of instruction file destinations per provider
`skills_registry.json`	Registry of skills (local directories or skills-cli packages)

Prerequisites

Tool	Purpose
Python 3.8+	Runtime for `agent-config`
uv	Package manager
just	Task runner (optional, for `justfile` recipes)
Node.js + npx	Required only for `installer: skills-cli` manifest entries
Git	Required for `pull` command (`git add`) and submodules

Environment Variables

Variable	Description
`AGENT_CONFIG_DIR`	Override the default config directory (equivalent to `--config-dir`)

Supported MCP Providers

Out of the box: VS Code, GitHub Copilot CLI, Claude Desktop, OpenCode, Cursor, Windsurf, JetBrains Junie.

Add custom providers with agent-config providers add.

Cross-Platform

Works on Windows (PowerShell), macOS, and Linux. Path expansion supports both %USERPROFILE% (Windows) and ~ / $HOME (POSIX).

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 0

Native requirements

0 direct targetsNot calculated transitive count

No declared dependencies in this collected response

Declarations describe requirements; they are not a resolved dependency graph.

Distribution files

2 collected

agentcfg-0.2.1-py3-none-any.whl

bdist_wheel · 17.65 KB · Python py3

Source file

agentcfg-0.2.1.tar.gz

sdist · 18.69 KB · Python source

Source file

Repository

PENDING

chrisbewz/agent-config

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 20 Oct, 21:37 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:c50053211fd3efdf2a3976f06b318c899596ae85a38bb2ee74b955b4369ea734

Other collected versions

View all collected versions →