https://github.com/louisbrulenaudet/bodyboard
Canonical instructions for coding assistants from a single AGENTS.md ✨
https://github.com/louisbrulenaudet/bodyboard
adapter agentic-ai agents cline codex copilot cursor gemini gemini-cli github-copilot openai-codex vibe vibe-coding
Last synced: about 1 month ago
JSON representation
Canonical instructions for coding assistants from a single AGENTS.md ✨
- Host: GitHub
- URL: https://github.com/louisbrulenaudet/bodyboard
- Owner: louisbrulenaudet
- License: apache-2.0
- Created: 2025-08-29T14:56:04.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-08-29T19:36:04.000Z (about 2 months ago)
- Last Synced: 2025-08-29T21:44:54.336Z (about 2 months ago)
- Topics: adapter, agentic-ai, agents, cline, codex, copilot, cursor, gemini, gemini-cli, github-copilot, openai-codex, vibe, vibe-coding
- Language: TypeScript
- Homepage: https://github.com/louisbrulenaudet/bodyboard
- Size: 27.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Canonical instructions for coding assistants from a single AGENTS.md
[](https://biomejs.dev/)
[](./LICENSE)
[](https://snyk.io/test/github/louisbrulenaudet/bodyboard)
[](https://github.com/louisbrulenaudet/bodyboard/actions/workflows/ci.yaml)
Maintaining consistency across diverse code assistant configuration files presents challenges, especially when updates are required for multiple tools and collaboration involves several contributors. **Bodyboard** addresses this by generating canonical instructions for code helpers from a single `AGENTS.md` file, thereby streamlining the production of adapter outputs for Gemini CLI, Copilot, Cline, Claude, Rules, Windsurf, and OpenAI Codex integrations.
**Supported adapters:** Gemini, Copilot, Cline, Claude, Rules (Zod), Windsurf
```bash
npm install -g bodyboard
```
Generate adapter outputs for all supported formats:
```bash
bodyboard create all
```
Or, generate a specific adapter output. For example for Gemini CLI:
```bash
bodyboard create gemini
```
### Generate Specific Adapter Output
- Gemini: `bodyboard create gemini`
- Copilot: `bodyboard create copilot`
- Cline: `bodyboard create cline`
- Claude: `bodyboard create claude`
- Rules: `bodyboard create rules`
- Windsurf: `bodyboard create windsurf`
#### Options
- `--out `: Output root directory (default: current repo)
- `--dry-run`: Show paths and diffs without writing
- `--verbose`: Detailed logs
#### Example Output Files
- `GEMINI.md`, `.gemini/settings.template.json`
- `.github/copilot-instructions.md`
- `.clinerules/instructions.md`
## Workflow
1. Edit [`AGENTS.md`](./AGENTS.md) with canonical instructions.
2. Run CLI to generate all formats for code helpers.
3. All writes are atomic; folders are created recursively.
## Feedback
If you have any feedback, please reach out at [louisbrulenaudet@icloud.com](mailto:louisbrulenaudet@icloud.com).