diff --git a/AGENTS.md b/AGENTS.md index c76fb33..43db78e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -53,7 +53,7 @@ Load only what the task needs. Skills live in `.agents/skills/` (linked into `.c ## Graft — repo context graph This repo is indexed in `graft/`: small linked markdown nodes that explain each -system and carry exact file:line spans, kept in sync with the code through git. +system and carry exact file:line spans (local cache regenerated via `graft build`). For ANY task here — understanding how something works, finding where code lives, or scoping a change — get context from the graph before grepping or opening diff --git a/README.md b/README.md index f3a7c65..d9d0daf 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,11 @@ **Set up a new or existing project for AI coding agents with one command.** +[![npm version](https://img.shields.io/npm/v/@antomanc/aginit)](https://www.npmjs.com/package/@antomanc/aginit) +[![CI](https://github.com/antomanc/aginit/actions/workflows/ci.yml/badge.svg)](https://github.com/antomanc/aginit/actions/workflows/ci.yml) +[![Node version](https://img.shields.io/node/v/@antomanc/aginit)](https://www.npmjs.com/package/@antomanc/aginit) +[![License](https://img.shields.io/github/license/antomanc/aginit)](LICENSE) + aginit gives a repo what agents need to do good work from the first session: an `AGENTS.md` that routes each task to the right doc, a curated set of engineering skills, a codebase graph so agents read less and understand more, a test harness they can actually run, and a way to @@ -12,10 +17,6 @@ backend and CLI projects, and it wires up upstream tools instead of reimplementi npx @antomanc/aginit ``` -[![CI](https://github.com/antomanc/aginit/actions/workflows/ci.yml/badge.svg)](https://github.com/antomanc/aginit/actions) -[![npm version](https://img.shields.io/npm/v/@antomanc/aginit)](https://www.npmjs.com/package/@antomanc/aginit) -[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) -

aginit v2 detecting a web project, configuring capabilities and e2e, and passing every doctor check

> **Beta.** Expect flags and defaults to change before 1.0. @@ -57,8 +58,9 @@ pnpm dlx @antomanc/aginit # same, with pnpm npm install -g @antomanc/aginit # or install globally and run `aginit` ``` -The wizard creates a new project or initializes the current directory, then asks for a -preset, framework and package manager. Existing projects keep the package manager they +The wizard creates a new project or initializes the current directory, auto-detects your stack, +and walks you through platform, methodology, design, testing, UI driver, and add-on choices with +a setup summary before writing any files. Existing projects keep the package manager they already use. Graft is installed separately (or skip it with `--no-graft`): diff --git a/docs/assets/demo.gif b/docs/assets/demo.gif index 18da6b7..ef60d65 100644 Binary files a/docs/assets/demo.gif and b/docs/assets/demo.gif differ diff --git a/docs/assets/demo.tape b/docs/assets/demo.tape index eb24e75..b87df4a 100644 --- a/docs/assets/demo.tape +++ b/docs/assets/demo.tape @@ -2,16 +2,19 @@ # Requires vhs, ttyd, ffmpeg, JetBrains Mono, graft, agent-browser and network access. # npx aginit resolves to our local build; all setup/doctor output is real. Output docs/assets/demo.gif + Set Shell bash Set FontFamily "JetBrains Mono" -Set FontSize 16 -Set Width 1100 -Set Height 680 -Set Padding 24 +Set FontSize 18 +Set LineHeight 1.25 +Set Width 1140 +Set Height 720 +Set Padding 28 Set WindowBar Colorful Set Theme "Catppuccin Mocha" -Set TypingSpeed 45ms -Set Framerate 20 +Set TypingSpeed 75ms +Set Framerate 30 +Set CursorBlink false Hide Type "source scripts/demo-setup.sh" @@ -19,59 +22,88 @@ Enter Sleep 500ms Ctrl+L Show -Sleep 1.2s +Sleep 1s +# 1. Launch the interactive wizard (let the viewer read the command!) Type "npx aginit" +Sleep 600ms Enter + +# 2. Target directory (auto-detected Vite project) Wait+Screen /What would you like to do/ -Sleep 650ms -# Existing Vite marker defaults to Current directory. +Sleep 1.3s Enter + +# 3. Platform (auto-detected Web) Wait+Screen /Platform/ -Sleep 700ms +Sleep 1.3s Enter + +# 4. Methodology: browse options smoothly so the viewer can read them Wait+Screen /Methodology/ +Sleep 900ms +Down +Sleep 750ms Down -Sleep 650ms +Sleep 750ms Up -Sleep 650ms +Sleep 500ms +Up +Sleep 900ms Enter + +# 5. Design system (highlight Impeccable) Wait+Screen /Design/ -Sleep 700ms +Sleep 1.4s Enter + +# 6. Testing engine: step down one-by-one to e2e and pause on it! Wait+Screen /Testing engine/ -# Existing project runner -> e2e (Vitest, Native, Playwright, e2e). -Down 2 -Sleep 700ms +Sleep 900ms +Down +Sleep 550ms +Down +Sleep 1.4s Enter + +# 7. UI driver (highlight agent-browser) Wait+Screen /UI driver/ -Sleep 700ms +Sleep 1.4s Enter + +# 8. Add-ons: toggle Karpathy / Context-Mode slowly so viewer sees multiselect Wait+Screen /Add-ons/ -# Show optional selection, then leave the baseline free of extra integrations. +Sleep 900ms Space -Sleep 650ms +Sleep 800ms Space -Enter -# No lockfile in the fixture: choose pnpm for the existing Node project. Sleep 700ms Enter -Sleep 700ms -Sleep 1.2s + +# 9. Package manager selection (pnpm) +Sleep 1.1s +Enter + +# 10. THE MONEY SHOT #1: The Setup Summary! +# Give the viewer 2.8 seconds to read the full stack configuration before confirming. +Sleep 2.8s Screenshot node_modules/.release/demo-summary.png Enter -# Upstream installs run unmodified; omit network-dependent time from the recording. + +# 11. Run real upstream installs off-camera, then show the completion output! Hide Wait+Screen@10m /Setup exited: 0/ -Ctrl+L Show -Sleep 1.2s +Sleep 2.4s + +# 12. THE MONEY SHOT #2: Verify everything with aginit doctor Type "aginit doctor" Sleep 600ms Enter Hide Wait+Screen@2m /All [0-9]+ health checks passed/ Show -Sleep 2.5s +# Hold on the final green 17/17 screen so the GIF loop feels rewarding +Sleep 4s Screenshot node_modules/.release/demo-doctor.png -Sleep 100ms +Sleep 200ms