https://github.com/dubsopenhub/agentic-loops
Standalone agentic loop templates, examples, and safety utilities.
https://github.com/dubsopenhub/agentic-loops
agentic-loops agents automation copilot templates
Last synced: 2 days ago
JSON representation
Standalone agentic loop templates, examples, and safety utilities.
- Host: GitHub
- URL: https://github.com/dubsopenhub/agentic-loops
- Owner: DUBSOpenHub
- License: mit
- Created: 2026-06-06T06:39:50.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-06T06:41:29.000Z (about 2 months ago)
- Last Synced: 2026-07-07T22:21:29.168Z (23 days ago)
- Topics: agentic-loops, agents, automation, copilot, templates
- Language: JavaScript
- Size: 15.6 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Agentic Loops
[](https://github.com/DUBSOpenHub/agentic-loops/actions/workflows/ci.yml)
[](LICENSE)
A home for standalone agentic loops: tiny programs that can observe, decide, act, judge, save state, and stop safely.
The goal is to make every loop reusable and understandable:
```text
Goal -> Observe -> Decide -> Act -> Judge -> Save -> Repeat or Stop
```
## Quick start
```bash
npm run loop:hello
npm run loop:repo-health
```
Create a new loop from the template:
```bash
npm run new-loop my-daily-check
npm run loop my-daily-check
```
## Repo layout
```text
loops/
_template/ reusable starter loop
hello-loop/ tiny learning example
repo-health-check/ read-only repo inspection loop
shared/
loop.js generic loop runner
logger.js JSONL + console logger
state-store.js local JSON state helpers
approvals.js approval prompt helpers
scripts/
run-loop.js run any loop by folder name
new-loop.js create a loop from the template
```
## Safety model
Each loop should answer five questions:
| Question | Example |
|---|---|
| What is the goal? | "Check repo health and summarize risk." |
| What can it access? | "Current repo files, read-only." |
| What actions can it take? | "Read package.json, inspect git status, count TODOs." |
| How does it know it is done? | "All checks completed and summary generated." |
| When must it stop? | "After 5 attempts or timeout." |
Use `requiresApproval: true` on any action that writes files, sends messages, calls external systems, or changes production-like resources.
## Commands
| Command | What it does |
|---|---|
| `npm run loop:hello` | Runs the simplest learning loop |
| `npm run loop:repo-health` | Runs a read-only health check on this repo |
| `npm run loop ` | Runs `loops//loop.js` |
| `npm run new-loop ` | Creates a new loop folder from `loops/_template` |
| `npm test` | Runs unit tests for the loop runner |
| `npm run verify` | Checks syntax, runs tests, and runs examples |
## Scheduling
The loops are standalone. Run them manually, from cron, from a macOS LaunchAgent, from GitHub Actions, or from another daemon like Hoot.
Example cron entry for an hourly repo health check:
```cron
0 * * * * cd /Users/greggcochran/agentic-loops && npm run loop:repo-health
```
---
🐙 Created with 💜 by [@DUBSOpenHub] with the GitHub Copilot CLI.