🚀 AgentWorks

# 🚀 AgentWorks

**AgentWorks** is an AI operations platform for running many autonomous workflows like an organization. Define goals, build workflow agents, run them on schedules, and let Pulse, Auto-improve, Chief of Staff, and the dashboard help you manage by exception instead of watching logs.

[![Latest Release](https://img.shields.io/github/v/release/manishiitg/coding-agent-loop?label=release)](https://github.com/manishiitg/coding-agent-loop/releases/latest)
![macOS Apple Silicon](https://img.shields.io/badge/macOS-Apple%20Silicon-000000?logo=apple)
![Installer](https://img.shields.io/badge/install-curl%20%7C%20bash-2ea44f)
[![MIT License](https://img.shields.io/badge/license-MIT-green.svg)](#license--architecture-foundations)

## The Goal

AgentWorks is built for teams that want to scale from a few manually checked automations to **100+ goal-driven workflow agents**. The product is an operating system for an AI-run organization:

- **Workflows do the work**: reusable agents execute research, coding, reporting, browser tasks, back-office operations, and channel conversations.
- **Pulse keeps each workflow reliable**: after runs, it checks whether the workflow actually worked, records Bug/Goal verdicts, hardens operational issues, reports cost/time, backs up, publishes, and notifies only on meaningful transitions.
- **Auto-improve moves workflows toward goals**: on a schedule, it reads cross-run evidence, refreshes stale reports/learnings/KB/db contracts, adjusts cadence, and applies bigger changes only when evidence is strong and backed up.
- **Chief of Staff / Org Pulse manages the whole org**: it reads workflow evidence against `pulse/goals.html`, audits model/cost posture, harvests durable memory, and writes proposal-only recommendations for the user or builder.
- **The dashboard is the operating view**: it rolls workflow health, goal progress, costs, recommendations, and exceptions into one place so a human manages decisions, not every run.

The high-level loop is documented in [Workflow self-improvement & reporting](docs/workflow/self_improvement_and_reporting.md).

## Product Screenshots

**Workflow automation: plan, run, report, and supervise**

![AgentWorks workflow automation walkthrough](docs/assets/github/workflow-automation-demo.gif)

**Operating loop: Pulse, Auto Improve, Chief of Staff, and org goals**

![AgentWorks operating loop walkthrough](docs/assets/github/operating-loop-demo.gif)

**Multi-CLI coding agents: Claude Code, Codex CLI, Cursor CLI, and Pi.dev**

![AgentWorks multi-CLI coding agent management](docs/assets/github/multi-cli-management-demo.gif)

**Workflow automation workspace**

![AgentWorks automation workspace](docs/assets/github/01-automation-workspace.png)

**Chief of Staff and Org Pulse**

![AgentWorks Chief of Staff](docs/assets/github/02-chief-of-staff.png)

**Goal-driven operations**

![AgentWorks org goals](docs/assets/github/03-org-goals.png)

**Daily operating pulse**

![AgentWorks org pulse](docs/assets/github/04-org-pulse.png)

## 💻 Desktop App (macOS)

A standalone macOS app is available — no Docker, no manual server setup. Each release is published at [Releases](https://github.com/manishiitg/coding-agent-loop/releases/latest).

Rename note: the public product and macOS bundle are **AgentWorks** and the GitHub repository is `coding-agent-loop`. New desktop releases use `AgentWorks-*` filenames. The historical local data directory is retained so existing local workflows remain available. The former `mcp-agent-builder-go` repository URL redirects to this repository but should not be used in new documentation.

### Install (one-liner — recommended)

```bash
curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bash
```

Downloads the latest dmg, installs the Mac app to `/Applications`, ensures the MCP bridge used by Claude Code/Codex tool access is installed to `~/go/bin`, strips the macOS quarantine flag (no "damaged" warning), and launches the app. If Go is missing, the installer installs Go through Homebrew when available; otherwise it asks you to install Go and rerun the same curl command. Pin a specific version with `RUNLOOP_VERSION=v1.25.6 curl -fsSL … | bash`.

### Install manually

1. Download the `AgentWorks-<version>-arm64.dmg` file from the latest release.
2. Open the dmg, drag the app to Applications.

### First-launch error: *"AgentWorks is damaged and can't be opened"*

The current build is **unsigned and not notarized**, so macOS Gatekeeper flags it on download. The app itself is fine — you just need to clear the quarantine flag macOS automatically attaches to downloaded files.

**Recommended — Terminal (works on all macOS versions):**
```bash
xattr -cr /Applications/AgentWorks.app
```
For an older release that is still installed under the legacy name, use:
```bash
xattr -cr /Applications/Runloop.app
```
Then double-click the app. If macOS still complains, also strip the dmg you downloaded:
```bash
xattr -cr

... (truncated)