agentsmd 1.2.0

CLI tool for scaffolding and syncing AI agent workspace configuration files

AgentsMD

CLI tool for scaffolding and syncing AI agent workspace configuration files.

Installation

pip install agentsmd

Quick Start

# First, authenticate (get a token from https://agentsmd.live)
agentsmd login --token <your-token>

# Create a new workspace in the current folder
agentsmd init

# Push your workspace to the cloud
agentsmd sync

On another machine

agentsmd login --token <same-token>
agentsmd init                    # pick your workspace from the list

Features

• Import-or-Generate Init — agentsmd init detects existing agent files (CLAUDE.md, .cursor/rules/, .claude/, .cursorrules, .windsurfrules, copilot-instructions.md, CONVENTIONS.md, .clinerules, .continue/, AGENTS.md, .rules, KIMI.md…) and imports them. If none are present, it asks one question (which tool?) and scans your repo (package.json scripts, framework, README) to generate a single high-quality config file.
• Multi-Machine Sync — Push and pull workspaces across machines with a single token
• Cross-Tool Sync — Convert between AI tool config formats (Claude Code, Cursor, Copilot, Windsurf)
• Format Migration — Migrate existing config files between formats
• Reconciliation — Re-derive all tool formats from a single source of truth

How workspaces work

Each workspace is identified by a user-chosen name (not by folder name). The local folder is bound to its cloud workspace via .agentsmd/workspace.json, which is created on init/clone/link and added to your .gitignore. You can rename or move the folder freely — the binding stays intact.

A free account includes one workspace; Pro unlocks unlimited.

Commands

Command	Description
agentsmd login --token <X>	Authenticate via API token
agentsmd logout	Clear local credentials
agentsmd init	Show workspace picker (clone existing or create new)
agentsmd init --name NAME	Create a new workspace (shortcut when no cloud workspaces exist)
agentsmd init --from <name>	Clone an existing workspace by name
agentsmd init --force	Overwrite a target file in generate-mode if it already exists
agentsmd init --no-push	Skip the automatic cloud upload at the end of init
agentsmd list	List your cloud workspaces
agentsmd link <name>	Bind the current folder to an existing workspace
agentsmd link --remove	Remove the local binding (cloud workspace is preserved)
agentsmd up	Upload local changes to the cloud
agentsmd down	Download cloud changes to local
agentsmd sync	Bidirectional sync with the cloud
agentsmd status	Show sync status for the current workspace
agentsmd convert --reconcile	Re-derive all tool config formats from the source of truth
agentsmd convert --from <fmt>	Convert between AI tool config formats

Supported AI Tools

agentsmd init detects and syncs config from any of these. Generate-mode picks one as the target.

Tool	Files
Claude Code	CLAUDE.md, .claude/
Cursor	.cursorrules, .cursor/rules/*.mdc
GitHub Copilot	.github/copilot-instructions.md, .github/instructions/
Windsurf	.windsurfrules, .windsurf/rules/
OpenCode / Codex	AGENTS.md
Aider	CONVENTIONS.md, .aider.conf.yml
Cline	.clinerules
Continue	.continue/
Zed	.rules
Kimi CLI	KIMI.md, .kimi/

Requirements

• Python 3.9+