# Social Media Launch Posts

Ready-to-use posts for promoting Aegis. Copy-paste and adjust as needed.

---

## Reddit r/Python

**Title:** Aegis -- Open-source policy engine for AI agents (YAML rules, approval gates, audit logs)

AI agents are getting real-world access to APIs, browsers, and SaaS tools. But there's no governance layer -- a hallucinating agent can bulk-delete your CRM or trigger irreversible API calls.

I built **Aegis** to fix this. It's a Python library that sits between your agent and the real world:

- **YAML policy rules** -- classify actions by risk level (low/medium/high/critical)
- **Approval gates** -- auto-execute safe actions, require human confirmation for risky ones, block dangerous ones
- **Smart conditions** -- time windows, weekday schedules, param thresholds
- **Full audit trail** -- SQLite, JSONL, or Python logging
- **Works with your stack** -- LangChain, CrewAI, OpenAI Agents SDK, Anthropic Claude, Playwright, httpx

3 lines to add governance:
```python
from aegis import Action, Policy, Runtime
runtime = Runtime(executor=your_executor, policy=Policy.from_yaml("policy.yaml"))
results = await runtime.run_one(Action("write", "salesforce", params={...}))
```

It's MIT licensed, fully typed (mypy strict), 90%+ test coverage, and has comprehensive docs.

GitHub: https://github.com/Acacian/aegis
PyPI: `pip install agent-aegis`
Docs: https://acacian.github.io/aegis/

Would love feedback! There are good-first-issues if anyone wants to contribute.

---

## Reddit r/MachineLearning

**Title:** [P] Aegis: Governance layer for AI agents -- policy engine + approval gate + audit log

Quick overview: Aegis is a Python library that adds governance to AI agents. You define YAML policies (risk levels, approval requirements, conditions), and it enforces them at runtime with human-in-the-loop approval and full audit logging.

Why: As agents get tool_use capabilities (Anthropic, OpenAI), there's no standard way to govern what they can do. Aegis provides that missing layer.

Key features:
- YAML-first policy engine with glob matching + smart conditions
- 4-tier risk model (low/medium/high/critical)
- Pluggable approval handlers (CLI, callbacks, custom)
- Audit trail (SQLite/JSONL/logging)
- Adapters for LangChain, CrewAI, OpenAI Agents SDK, Anthropic Claude, httpx, Playwright

GitHub: https://github.com/Acacian/aegis

---

## X (Twitter)

**Post 1 (Launch):**
Shipped Aegis -- an open-source governance layer for AI agents.

Your agent can call APIs, browse the web, modify SaaS data. Aegis makes sure it asks permission first.

YAML policies -> approval gates -> audit logs

Works with LangChain, CrewAI, OpenAI, Anthropic, Playwright.

pip install agent-aegis

https://github.com/Acacian/aegis

**Post 2 (Technical):**
The "sudo for AI agents" problem:

1. Agent wants to bulk-delete CRM contacts
2. Policy engine: risk=CRITICAL, approval=BLOCK
3. Action blocked + logged

3 lines of Python. YAML policies. Full audit trail.

That's Aegis.

https://github.com/Acacian/aegis

**Post 3 (Thread starter):**
I built an open-source governance layer for AI agents. Here's why:

AI agents are getting real-world access. But there's no "permission system" for them.

A hallucinating agent can:
- Bulk-delete your CRM
- Submit wrong forms
- Trigger irreversible API calls at 3am

Thread on how Aegis solves this:

---

## Hacker News

**Title:** Show HN: Aegis -- Open-source policy engine for AI agents

**Text:**
Hi HN, I built Aegis -- an open-source Python library that adds governance to AI agents.

The problem: AI agents are getting real-world access (tool_use, function calling, browser automation), but there's no standard governance layer. A hallucinating agent can bulk-delete your CRM or trigger irreversible API calls.

Aegis sits between your agent and the real world:
- YAML policy rules classify actions by risk (low/medium/high/critical)
- Approval gates auto-execute safe ops, require human confirmation for risky ones
- Smart conditions: time windows, param thresholds, weekday schedules
- Full audit trail (SQLite, JSONL, Python logging)
- Works with LangChain, CrewAI, OpenAI Agents SDK, Anthropic Claude, httpx, Playwright

It's MIT licensed, mypy strict, 90%+ coverage.

GitHub: https://github.com/Acacian/aegis
Docs: https://acacian.github.io/aegis/
PyPI: pip install agent-aegis

I'd love feedback on the API design and policy syntax.
