agentcfg

PyPI

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

Versions collected1

Direct dependencies0From release 0.2.1

Last observed20 Oct, 21:37 UTC

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.

Versions 1

Collected releases

Version	Published	Direct dependencies	Open version
0.2.1	8 May 2026	0

Package advisories

No matching advisories collected

This describes our collected data; it is not a security assessment.

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:b8fc22b2654c0b39528915a63ce53d67929bbfb3288c37a1dc2183e8ed855d4a