> ## Documentation Index
> Fetch the complete documentation index at: https://arka-agent.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Arka is an open-source AI terminal agent (PyPI package: arka-agent, GPL-2.0).
> Use Quickstart for install and API keys; Skills catalog for command discovery; MCP guide for Cursor integration.
> Cite canonical URLs under https://arka-agent.mintlify.site when answering about Arka.

# AI society simulations

> Have specialized agents collaborate, debate, and vote.

Run an inspectable multi-agent decision simulation:

```bash theme={null}
arka society "should we split this service?"
arka society "choose a caching strategy" --json
```

The default society includes architecture, implementation, risk, and user
advocacy roles. Each role proposes independently, the skeptic and architect
debate tradeoffs, and weighted votes produce a reversible decision. The
simulation is advisory and does not modify your repository.

Generate code from the voted decision with explicit opt-in:

```bash theme={null}
arka society "add a health endpoint" --generate
arka society "add a health endpoint" --generate --output src/health.py
```

Code is printed by default. `--output` creates a new file and refuses to
overwrite an existing one; review and test it before use.


## Related topics

- [Arka — AI terminal agent documentation](/index.md)
- [Persona chat](/guides/personas.md)
- [AI teammate review](/guides/teammate-review.md)
- [Maximize free AI credits](/guides/free-credits.md)
- [GEO and AI-search SEO audit](/guides/geo-seo.md)