{"id":44990435,"url":"https://github.com/baton-dx/baton-dx","last_synced_at":"2026-03-13T17:00:59.313Z","repository":{"id":339246869,"uuid":"1158149058","full_name":"baton-dx/baton-dx","owner":"baton-dx","description":"CLI package manager for AI coding tool configuration — one manifest for 14 tools","archived":false,"fork":false,"pushed_at":"2026-03-12T14:31:16.000Z","size":1712,"stargazers_count":2,"open_issues_count":7,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-12T18:58:53.640Z","etag":null,"topics":["agentic-coding","agentic-workflow","ai","ai-tools","claude-code","cli","copilot","cursor","developer-experience","developer-tools","dotfiles","dx","vibe-coding"],"latest_commit_sha":null,"homepage":"https://github.com/baton-dx/baton-dx","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/baton-dx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-14T21:52:56.000Z","updated_at":"2026-03-12T14:02:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/baton-dx/baton-dx","commit_stats":null,"previous_names":["baton-dx/baton-dx"],"tags_count":51,"template":false,"template_full_name":null,"purl":"pkg:github/baton-dx/baton-dx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baton-dx%2Fbaton-dx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baton-dx%2Fbaton-dx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baton-dx%2Fbaton-dx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baton-dx%2Fbaton-dx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/baton-dx","download_url":"https://codeload.github.com/baton-dx/baton-dx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/baton-dx%2Fbaton-dx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30471114,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T11:00:43.441Z","status":"ssl_error","status_checked_at":"2026-03-13T11:00:23.173Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-coding","agentic-workflow","ai","ai-tools","claude-code","cli","copilot","cursor","developer-experience","developer-tools","dotfiles","dx","vibe-coding"],"created_at":"2026-02-18T21:18:12.139Z","updated_at":"2026-03-13T17:00:59.306Z","avatar_url":"https://github.com/baton-dx.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Baton DX \u003csub\u003e/bəˈtɑːn/\u003c/sub\u003e\n\n[![npm version](https://img.shields.io/npm/v/@baton-dx/cli.svg)](https://www.npmjs.com/package/@baton-dx/cli)\n[![CI Status](https://github.com/baton-dx/baton-dx/workflows/CI/badge.svg)](https://github.com/baton-dx/baton-dx/actions)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**Baton is a CLI package manager for Developer Experience \u0026 AI configuration.** Manage Skills, Rules, Agents, Memory Files, and file configs as versioned, composable profiles for 14 AI coding tools.\n\n## What's New in v1.0.0\n\nv1.0.0 is the first stable release of Baton. Key changes from 0.x:\n\n- **Convention over Configuration** — Drop files into `ai/rules/`, `ai/agents/`, `ai/skills/` and Baton discovers them. No manifest declarations needed.\n- **`baton preview`** — Inspect processed output for any AI tool before syncing. Supports `--diff` to compare two tools side by side.\n- **Directives** — `baton:if` / `baton:else` / `baton:endif` with expression syntax, and `baton:include` with `inline` / `link` / `reference` modes.\n- **MCP Server Distribution** — Define MCP servers once in `ai/mcp/*.yaml`; Baton places them in each tool's native config format with per-tool env-var syntax transformations.\n- **Profile Inheritance** — `extends: ../base` in `baton.profile.yaml` for layered configuration.\n- **`baton self-update`** — Update Baton to the latest version from the CLI.\n- **`baton source validate`** — Validate a source repository's structure and manifests.\n- **`baton sync` replaces `baton update`** — The old `baton update` command has been removed.\n\nSee [Migration Guide](docs/MIGRATION-1.0.md) for upgrading from 0.x.\n\n## Why Baton?\n\n| | Without Baton | With Baton |\n|---|---|---|\n| **Setup** | Manually copy and adapt config files for each AI tool | `baton init` + `baton sync` — done in seconds |\n| **Team Consistency** | Config drift — every dev diverges over time | One source of truth, version-locked with `baton.lock` |\n| **Cross-Project** | Each repo has its own ad-hoc AI configs, no shared standard | Same profiles across all your projects — consistent by default |\n| **Multiple Tools** | Even 2–3 AI tools mean 2–3 different formats to maintain | One manifest, automatically transformed per tool |\n| **Onboarding** | New devs spend hours recreating the \"right\" AI setup | `baton sync` — match the team instantly |\n\n**Without Baton** — manual config per project, per tool:\n\n```mermaid\ngraph TB\n    D(\"Developer\"):::person --\u003e P1(\"Project A\"):::project\n    D --\u003e P2(\"Project B\"):::project\n    D --\u003e P3(\"Project C\"):::project\n\n    P1 --\u003e T1A(\"Claude Code\"):::config\n    P1 --\u003e T1B(\"Cursor\"):::config\n    P1 --\u003e T1C(\"Copilot\"):::config\n\n    P2 --\u003e T2A(\"Claude Code\"):::config\n    P2 --\u003e T2B(\"Cursor\"):::config\n    P2 --\u003e T2C(\"Copilot\"):::config\n\n    P3 --\u003e T3A(\"Claude Code\"):::config\n    P3 --\u003e T3B(\"Cursor\"):::config\n    P3 --\u003e T3C(\"Copilot\"):::config\n\n    classDef person fill:#fee2e2,stroke:#fca5a5,color:#991b1b,stroke-width:2px\n    classDef project fill:#fff7ed,stroke:#fdba74,color:#9a3412,stroke-width:2px\n    classDef config fill:#fef2f2,stroke:#fca5a5,color:#b91c1c,stroke-width:1px\n\n    linkStyle default stroke:#f87171,stroke-width:1.5px\n```\n\n**With Baton** — one source, every project in sync:\n\n```mermaid\ngraph TB\n    S(\"Source Repo\"):::source --\u003e|\"baton sync\"| P1(\"Project A\"):::project\n    S --\u003e|\"baton sync\"| P2(\"Project B\"):::project\n    S --\u003e|\"baton sync\"| P3(\"Project C\"):::project\n\n    P1 --\u003e T1(\"All tools configured\"):::done\n    P2 --\u003e T2(\"All tools configured\"):::done\n    P3 --\u003e T3(\"All tools configured\"):::done\n\n    classDef source fill:#dcfce7,stroke:#86efac,color:#166534,stroke-width:2px\n    classDef project fill:#f0fdf4,stroke:#86efac,color:#166534,stroke-width:2px\n    classDef done fill:#bbf7d0,stroke:#4ade80,color:#14532d,stroke-width:2px\n\n    linkStyle default stroke:#4ade80,stroke-width:1.5px\n```\n\nBaton currently supports 14 AI coding tools — see the [full list below](#supported-ai-tools).\n\n## Quick Start\n\n```bash\n# Install\nbun install -g @baton-dx/cli\n\n# Connect your team's source repository\nbaton source connect github:your-org/dx-configs --name my-team\n\n# Initialize in any project\nbaton init\n\n# Sync all configurations\nbaton sync\n```\n\n## Features\n\n- **Convention over Configuration** — Drop files into `ai/rules/`, `ai/agents/`, `ai/skills/` and Baton discovers them automatically\n- **Unified AI Configuration** — One profile for 14 AI coding tools\n- **MCP Server Distribution** — Define MCP servers once in `ai/mcp/*.yaml`, placed into each tool's native config format\n- **Profile Inheritance** — Compose profiles with `extends` for layered configuration\n- **Directives** — Conditional content and file inclusion with `baton:if` and `baton:include`\n\n### Directives — Smart Composition\n\nBaton profiles use directives to compose content dynamically based on the target project and tool:\n\n```markdown\n\u003c!-- baton:if has=\"typescript\" --\u003e\n## TypeScript Standards\n\u003c!-- baton:include src=\"fragments/typescript.md\" --\u003e\n\u003c!-- baton:endif --\u003e\n\n\u003c!-- baton:if tool=\"claude-code\" --\u003e\nUse @file to reference project files.\n\u003c!-- baton:else --\u003e\nReference files by relative path.\n\u003c!-- baton:endif --\u003e\n\n\u003c!-- baton:if condition=\"(tool == 'claude-code' OR tool == 'cursor') AND has('typescript')\" --\u003e\nTypeScript-aware AI tool detected.\n\u003c!-- baton:endif --\u003e\n\n\u003c!-- baton:include src=\"@project/PROJECT.md\" --\u003e\n```\n\nConditions: `tool`, `ide`, `scope`, `type`, `file`, `var`, `has` — with AND/OR composition and expression syntax.\nInclude modes: `inline`, `link`, `reference` — with `@project/` for project-relative resolution.\n- **Smart Sync** — Transform and place files in the correct format for each tool\n- **Version Control** — Lockfile-based reproducibility with SHA-256 integrity\n- **Auto-Detection** — Automatically detect installed AI tools and IDEs\n- **Scaffold Templates** — Bootstrap source repositories with `baton source create`\n\n## Supported AI Tools\n\n| Tool | Key | Tool | Key |\n|------|-----|------|-----|\n| Claude Code | `claude-code` | OpenCode | `opencode` |\n| Cursor | `cursor` | Amp | `amp` |\n| Windsurf | `windsurf` | Kiro | `kiro` |\n| Antigravity | `antigravity` | Zed | `zed` |\n| Codex CLI | `codex` | Cline | `cline` |\n| GitHub Copilot | `github-copilot` | Roo | `roo` |\n| Junie | `junie` | Trae | `trae` |\n\n## Official Source Repository\n\nBaton's own configurations are published as [`baton-dx-source`](https://github.com/baton-dx/baton-dx-source) — a real-world example of sources and profiles in action:\n\n| Profile | Command | Audience |\n| ------- | ------- | -------- |\n| **maintainer** | `baton init --profile github:baton-dx/baton-dx-source/maintainer` | Contributors to this repo |\n| **creator** | `baton init --profile github:baton-dx/baton-dx-source/creator` | Developers building their own sources and profiles |\n| **consumer** | `baton init --profile github:baton-dx/baton-dx-source/consumer` | Developers using Baton in their projects |\n\n## Documentation\n\n- [Installation](docs/01-installation.md) — Prerequisites and install methods\n- [Quick Start Guide](docs/02-quickstart.md) — Get running in 5 minutes\n- [Using Sources](docs/03-using-sources.md) — Connect and use source repositories\n- [Using Profiles](docs/04-using-profiles.md) — Use profiles in your projects\n- [Creating Sources](docs/05-creating-sources.md) — Build source repositories\n- [Creating Profiles](docs/06-creating-profiles.md) — Design profile manifests\n- [CLI Reference](docs/07-cli-reference.md) — Complete command reference\n- [Configuration Reference](docs/08-configuration-reference.md) — All config file schemas\n- [AI Tools Reference](docs/09-ai-tools-reference.md) — All 14 supported AI tools\n- [IDE Platforms](docs/10-ide-platforms-reference.md) — Supported IDE platforms\n- [Merge Strategies](docs/11-merge-strategies.md) — Deep dive into merge strategies\n- [Migration Guide](docs/MIGRATION-1.0.md) — Upgrading from 0.x\n- [Contributing](docs/12-contributing.md) — How to contribute to Baton\n- [Troubleshooting](docs/13-troubleshooting.md) — Common issues and solutions\n\n## Built with AI, Verified by Humans\n\nBaton is proudly built with the help of AI tools. We believe AI-assisted development is a powerful accelerator — and as a tool that manages AI coding configurations, we practice what we preach. At the same time, human review, testing, and judgment are essential for every contribution. We do not accept pull requests from fully autonomous bots (e.g., OpenClaw).\n\n## Contributing\n\nSee [Contributing Guide](docs/12-contributing.md) for development setup, coding conventions, and PR workflow.\n\n## License\n\nMIT © 2026 Baton Contributors\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaton-dx%2Fbaton-dx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbaton-dx%2Fbaton-dx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbaton-dx%2Fbaton-dx/lists"}