mcp-server

agentao

Name: agentao
Author: jin-bo

Local-first, governed AI agent runtime for Python — embed it in your app, or run it as a CLI or ACP server. Permissions, MCP, memory and audit replay built in.

309 stars+1★ this week (early data)13 forksPythonUpdated 10/10/2026100% free · open source

About this skill

Local-first, governed AI agent runtime for Python — embed it in your app, or run it as a CLI or ACP server. Permissions, MCP, memory and audit replay built in.

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/502be13d-5cb8-447a-b372-e42eed55ea9c && curl -fsSL https://workflowstacks.com/api/skills/502be13d-5cb8-447a-b372-e42eed55ea9c/claude-skill -o ~/.claude/skills/502be13d-5cb8-447a-b372-e42eed55ea9c/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How agentao works

Codeflow

Free to inspect

Agentao is a very large Python project (~113k lines across 382 code files, plus 388 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, MIT license, has a test suite.

Size

Very large codebase

~113k lines · 382 code files · days to read — use, don't read

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

Python

Needs API keys (.env)

Python 99%HTML 1%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
CLAUDE.md
The instructions the AI actually follows
3
main.py
Where the program starts running
4
pyproject.toml
Dependencies and the commands it exposes
5
.env.example
The API keys and settings you must provide

What's in each folder

agentao/Core code — the actual logic326 files

skills/Prompts, skills & agent definitions18 files

docs/Documentation293 files

examples/Examples you can copy145 files

developer-guide/Folder162 files

scripts/Helper scripts7 files

schemas/Data models & types5 files

tests/Tests — proof it works375 files

READMEHas testsDocumentedCI checksExamples includedMIT licenseUpdated this month