ai-dot 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ai-dot contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# ai-dot
+
+Configure once, generate for all AI coding tools.
+
+`ai-dot` reads a single `.ai/` config directory and emits native configuration files for Claude Code, Cursor, Codex, OpenCode, GitHub Copilot, and Antigravity.
+
+> **Alpha** — this tool is under active development. Expect breaking changes.
+
+## Install
+
+```bash
+npm install -g ai-dot
+```
+
+## Quick start
+
+```bash
+# Scaffold a new .ai/ directory
+ai-dot init
+
+# Generate config files for all targets
+ai-dot sync
+
+# Generate for specific targets
+ai-dot sync --target claude cursor
+
+# Check config validity
+ai-dot check
+
+# See what's changed since last sync
+ai-dot status
+```
+
+## How it works
+
+You define your AI coding config once in `.ai/`:
+
+```
+.ai/
+  config.yaml          # MCP servers, permissions, hooks, ignore patterns
+  directives/          # Markdown instruction files
+    code-style.md
+    testing.md
+  skills/              # Reusable skill definitions
+    commit/SKILL.md
+  agents/              # Agent definitions
+    reviewer.md
+```
+
+Then `ai-dot sync` generates the native config files each tool expects:
+
+| Target | Output |
+|--------|--------|
+| Claude Code | `CLAUDE.md`, `.claude/`, `.mcp.json` |
+| Cursor | `.cursor/`, `.cursorrules` |
+| Codex | `AGENTS.md`, `.codex/` |
+| OpenCode | `AGENTS.md`, `opencode.json` |
+| GitHub Copilot | `.github/copilot-instructions.md`, `.copilot/` |
+| Antigravity | `ANTIGRAVITY.md` |
+
+## Import existing config
+
+Already have config files for one tool? Import them:
+
+```bash
+# Import from existing Claude Code config
+ai-dot import --source claude
+
+# Import from Cursor
+ai-dot import --source cursor
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `ai-dot init` | Scaffold a `.ai/` directory with guided setup |
+| `ai-dot sync` | Generate config files for target tools |
+| `ai-dot check` | Validate config and report compatibility |
+| `ai-dot status` | Show sync state and detect manual edits |
+| `ai-dot import` | Import config from an existing tool |
+| `ai-dot add` | Add a directive, skill, or agent |
+
+## Programmatic usage
+
+```typescript
+import { loadConfig, emitAll } from "ai-dot";
+
+const config = await loadConfig({ scope: "project" });
+const files = emitAll(config);
+```
+
+## License
+
+MIT