# Documentation

AbstractAssistant is a macOS-first tray app and CLI that hosts a **local, durable agent** built on the
AbstractFramework ecosystem:
- **AbstractFramework**: https://github.com/lpalbou/AbstractFramework
- **AbstractCore** (providers, tools/media schemas): https://github.com/lpalbou/abstractcore
- **AbstractRuntime** (durable runs, waits, ledger): https://github.com/lpalbou/abstractruntime

## Start here

- **Install**: [INSTALLATION.md](INSTALLATION.md)
- **First run + core concepts**: [getting-started.md](getting-started.md)

## Reference

- **API & CLI reference**: [api.md](api.md)
- **Architecture & durability model** (includes diagrams): [architecture.md](architecture.md)
- **Gateway-first design draft** (thin-client plan): [gateway-first-design.md](gateway-first-design.md)
- **FAQ / troubleshooting**: [faq.md](faq.md)

## Development notes (internal)

Developer notes and experiments live under `devnotes/`. They are not part of the stable public docs:
- [devnotes/README.md](devnotes/README.md)

## Project info

- Contributing: [../CONTRIBUTING.md](../CONTRIBUTING.md)
- Security: [../SECURITY.md](../SECURITY.md)
- Changelog: [../CHANGELOG.md](../CHANGELOG.md)
- License: [../LICENSE](../LICENSE)
- Acknowledgments: [../ACKNOWLEDGMENTS.md](../ACKNOWLEDGMENTS.md)
