← Today's AI open source

Today's AI open source · 2026-11-12

KKKKhazix/agent-autoloop

Agent Autoloop is an automation tool that lets command-line AI agents take on tasks in the background and carry them through to completion.

AgentsCoding toolsMCP

Repositorygithub.com/KKKKhazix/agent-autoloop ↗
Main languageTypeScript
LicenseMIT
GitHub stars · forks★ 4,526 · 827 forks (as of 2026-11-12)
Created · last update2026-11-03 · 2026-11-11
GitHub topicsai-agents, automation, claude-code, cli, codex, event-driven, mcp, nodejs

Overview

Agent Autoloop is a lightweight automation relay that lets command-line agents such as Claude Code and Codex run without a person sitting at the terminal watching. When a scheduled time arrives or an external event comes in, it hands the task to an agent, and only for tasks that need judgment does it send a card to a person to get a decision.

The internal core that handles task scheduling has no external dependencies, and event sources, agents, notification channels and deployment pipelines are all swappable plugins. Users write in rules.json 'which task, to which agent, in which directory,' and the agent appends an agent-autoloop code block to the end of its final response to leave questions, notifications or follow-up check reservations. While waiting for a decision, it keeps no process running and uses no tokens; once it gets an answer, it resumes the original conversation and finishes the remaining work.

It suits developers who already use command-line agents and want to hand off recurring work such as responding to issues, writing morning reports or checking outage alerts. It runs on a single personal computer, without a cloud server or public ports.

Why it is worth a look

A notable design choice is that it lets command-line agents act as background workers that receive events and do work, rather than as interactive tools. It implements a Human-in-the-loop flow — asking a person only for risky tasks, using no resources while waiting, then returning to the same conversation to continue — through a single response format, without an SDK or changes to agent code.

Key features

What it is used for

Getting started

  1. Prepare Node 24 or later, Git and a logged-in command-line agent (macOS and Linux also need curl).
  2. Install with curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh on macOS and Linux, or irm https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1 | iex in Windows PowerShell.
  3. Run agent-autoloop try to go through the question, decision and continuation flow once.
  4. Add rules to ~/.agent-autoloop/rules.json, then check them with agent-autoloop check.

What to weigh

Related terms and companies

Sources

Written with AI assistance from the repository README and GitHub data. Star counts and other numbers are GitHub values as of the date shown; features and licensing can change, so check the repository.