Skip to content

Quick Start

1. Install the CLI

Terminal window
curl -fsSL https://aynig.org/install.sh | bash

If your PATH does not include ~/.local/bin, add it to your shell profile.

2. Initialize the repository

Terminal window
aynig init

This creates:

  • .aynig/ with starter files
  • .worktrees/ for ephemeral worktrees
  • a .worktrees/ entry in .gitignore

3. Add a command

Create a command directory:

Terminal window
mkdir -p .aynig/command

Create an executable file at .aynig/command/build with this content:

#!/usr/bin/env bash
set -euo pipefail
echo "Build requested: $AYNIG_BODY"

Make it executable:

Terminal window
chmod +x .aynig/command/build

4. Create a commit with a state

chore: request a build
Build the project.
aynig-state: build

5. Run AYNIG

Terminal window
aynig run

Next steps: