agentsmd 1.0.9

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

• Workspace Scaffolding — Interactive interview to generate AGENTS.md, CLAUDE.md, .cursorrules, and more
• 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	Proceed even if current directory is not empty
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

• Claude Code (CLAUDE.md)
• Cursor (.cursorrules)
• GitHub Copilot (.github/copilot-instructions.md)
• Windsurf (.windsurfrules)
• AGENTS.md (universal format)

Requirements

• Python 3.9+