Metadata-Version: 2.4
Name: agentsmd
Version: 1.0.9
Summary: CLI tool for scaffolding and syncing AI agent workspace configuration files
License-Expression: MIT
Author: Harshith: Admin
Author-email: contact@gentlabs.ai
Requires-Python: >=3.9,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Requires-Dist: httpx (>=0.28.0,<0.29.0)
Requires-Dist: jinja2 (>=3.1.0,<4.0.0)
Requires-Dist: pydantic (>=2.0.0,<3.0.0)
Requires-Dist: pyyaml (>=6.0,<7.0.0)
Requires-Dist: typer (>=0.9.0,<1.0.0)
Project-URL: Bug Tracker, https://gentlabs.ai/contact
Project-URL: Documentation, https://agentsmd.live/docs/cli
Project-URL: Homepage, https://agentsmd.live/
Description-Content-Type: text/markdown

# AgentsMD

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

## Installation

```bash
pip install agentsmd
```

## Quick Start

```bash
# 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

```bash
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+

