Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
14 changes: 8 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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)

<p align="center"><img src="https://raw.githubusercontent.com/antomanc/aginit/main/docs/assets/demo.gif" alt="aginit v2 detecting a web project, configuring capabilities and e2e, and passing every doctor check" width="720"></p>

> **Beta.** Expect flags and defaults to change before 1.0.
Expand Down Expand Up @@ -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`):
Expand Down
Binary file modified docs/assets/demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
88 changes: 60 additions & 28 deletions docs/assets/demo.tape
Original file line number Diff line number Diff line change
Expand Up @@ -2,76 +2,108 @@
# 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"
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
Loading