AgentWorks documentation
Getting Started
AgentWorks runs coding agents, model providers, browsers, and MCP tools as repeatable business workflows. This guide takes you from installation to a reviewed first run.
1. Install the macOS App
curl -fsSL https://raw.githubusercontent.com/manishiitg/mcp-agent-builder-go/main/install.sh | bash
The installer downloads the latest release, installs the app, installs the local MCP bridge, clears the macOS quarantine flag, and launches AgentWorks. See the latest release for manual installation artifacts.
2. Complete First-Launch Setup
On first launch:
- Choose the workspace folder that will hold
workspace-docs/. - Set
AUTH_SECRET. Reuse the existing value when opening an existing workspace because it encrypts stored provider credentials. - Configure at least one coding agent or model provider from the app's provider settings.
Provider keys are encrypted in <workspace-docs>/config/provider-api-keys.json.
3. Build the First Workflow
Follow Build Your First Workflow to create an automation, define its operating contract, run it, and review the result.
4. Operate and Improve
- Schedule recurring runs
- Monitor runs, reports, and costs
- Understand Pulse and reporting
- Configure evidence-based Auto Improve