Skip to content
All You Need Is Git

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

Inside the repository where you want to use AYNIG:

Terminal window
aynig init

This creates:

  • .dwp/ with starter files
  • .worktrees/ for ephemeral execution worktrees
  • .worktrees/ and .dwp/logs/ entries in .gitignore

3) Add a command

Create an executable command at .dwp/command/human-turn with something like this:

#!/bin/bash


case "$(uname)" in
  Darwin)
    osascript -e "display notification \"$AYNIG_BODY\" with title \"AYNIG\""
    afplay /System/Library/Sounds/Glass.aiff >/dev/null 2>&1 &
    ;;
  Linux)
    notify-send "AYNIG" "$AYNIG_BODY"
    paplay /usr/share/sounds/freedesktop/stereo/complete.oga >/dev/null 2>&1 &
    ;;
esac


aynig set-working "human-turn" --lease-seconds 3600

4) Create a commit with a state

Create a commit whose message includes a dwp-state: trailer:

chore: Implementation done


Please review and merge.


dwp-state: human-turn

5) Run AYNIG

Terminal window
aynig run

AYNIG will read HEAD, resolve the command for dwp-state: human-turn, execute it, and then the command should produce a new commit advancing the state.

What a command can do

Commands can do anything you can do in a script, including prompting agents.