iteratr

(★ 38)

Long-running Agent Loop Manager

File Explorer

  • .gitattributes
  • .gitignore
  • .goreleaser.yaml
  • .iteratr.hooks.example.yml
  • .iteratr.hooks.yml
  • .iteratr.template
  • .iteratr.test.template
  • AGENTS.md
  • architecture.md
  • btca.config.jsonc
  • component-tree.md
  • coverage.out
  • go.mod
  • go.sum
  • install.sh
  • iteratr.gif
  • iteratr.yml
  • README.md
  • skills-lock.json
  • Taskfile.yml

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

bun add

View Details ▼

Add and install new dependencies to the current project.

bun {{[a|add]}} {{package}}

Install a single package:

bun {{[a|add]}} {{package1 package2 ...}}

Install multiple packages:

bun {{[a|add]}} {{git_url}}

Install from a Git repository:

🔍

git add

View Details ▼

Stage changed files for a commit.

git add {{path/to/file}}

Stage a file for a commit:

git add {{[-A|--all]}}

Add all files (tracked and untracked):

git add .

Add all files recursively starting from the current folder:

🔍

git clone

View Details ▼

Clone an existing repository.

git clone {{remote_repository_location}} {{path/to/directory}}

Clone an existing repository into a new directory (the default directory is the repository name):

git clone --recursive {{remote_repository_location}}

Clone an existing repository and its submodules:

git clone {{[-n|--no-checkout]}} {{remote_repository_location}}

Clone only the `.git` directory of an existing repository:

🔍

git commit

View Details ▼

Commit files to the repository.

git commit

Open an editor to write a message and commit staged files to the repository:

git commit {{[-m|--message]}} "{{message}}"

Commit staged files to the repository with the specified message:

git commit {{[-F|--file]}} {{path/to/commit_message_file}}

Commit staged files with a message read from a file:

🔍

go build

View Details ▼

Compile Go sources.

go build {{path/to/main.go}}

Compile a 'package main' file (output will be the filename without extension):

go build -o {{path/to/binary}} {{path/to/source.go}}

Compile, specifying the output filename:

go build -o {{path/to/binary}} {{path/to/package}}

Compile a package:

🔍

go install

View Details ▼

Compile and install packages named by the import paths.

go install

Compile and install the current package:

go install {{path/to/package}}

Compile and install a specific local package:

go install {{golang.org/x/tools/gopls}}@{{latest}}

Install the latest version of a program, ignoring `go.mod` in the current directory:

🔍

opencode

View Details ▼

An AI coding agent.
Some subcommands such as `auth`, `models`, `web`, etc. have their own usage documentation.

opencode

Start the interactive TUI:

opencode {{[-c|--continue]}}

Continue the most recent session:

opencode run "{{message}}"

Run opencode in non-interactive mode by passing a prompt directly:

🔍

task

View Details ▼

To-do list manager.

task add {{description}} due:{{tomorrow}}

Add a new task which is due tomorrow:

task {{task_id}} modify priority:{{H|M|L}}

Update a task's priority:

task {{task_id}} done

Complete a task:

🔍

timeout

View Details ▼

Run a command with a time limit.

timeout 3s sleep 10

Run `sleep 10` and terminate it after 3 seconds:

timeout {{[-s|--signal]}} {{INT|HUP|KILL|...}} {{5s}} {{sleep 10}}

Send a signal to the command after the time limit expires (`TERM` by default, `kill -l` to list all signals):

timeout {{[-v|--verbose]}} {{0.5s|1m|1h|1d|...}} {{command}}

Send verbose output to `stderr` showing signal sent upon timeout:

🔍

tput

View Details ▼

View and modify terminal settings and capabilities.
See also: `stty`.

tput cup {{row}} {{column}}

Move the cursor to a screen location:

tput {{setaf|setab}} {{ansi_color_code}}

Set foreground (af) or background (ab) color:

tput rev

Reverse text and background colors:

🔍

vim

View Details ▼

Vim (Vi IMproved), a command-line text editor, provides several modes for different kinds of text manipulation.
Pressing `<i>` in normal mode enters insert mode. Pressing `<Esc>` goes back to normal mode, which enables the use of Vim commands.
See also: `vimdiff`, `vimtutor`, `nvim`, `gvim`.

vim {{path/to/file}}

Open a file:

vim +{{line_number}} {{path/to/file}}

Open a file at a specified line number:

<:>help<Enter>

View Vim's help manual:

# Project Badges

// repository documentation