# hrns

## Docs

- [Development](https://docs.hrns.dev/development.md): Contribute to hrns itself and keep the docs aligned with the current code.
- [Add a skill](https://docs.hrns.dev/guides/add-a-skill.md): Create SKILL.md files that hrns can discover and expose through the load_skill tool.
- [Add a tool](https://docs.hrns.dev/guides/add-a-tool.md): Extend hrns with custom tools that the model can call during the loop.
- [Embed hrns in your Go code](https://docs.hrns.dev/guides/embed-in-go.md): Compose the hrns packages directly when you want your own agent runtime instead of the bundled TUI.
- [Provider setup](https://docs.hrns.dev/guides/provider-setup.md): Configure hrns to talk to an OpenAI-compatible chat completion endpoint.
- [TUI workflow](https://docs.hrns.dev/guides/tui-workflow.md): Use the bundled terminal interface to probe prompts, tools, and model behavior.
- [hrns](https://docs.hrns.dev/index.md): A minimal Go harness for experimenting with tool-using AI agents and embedding them in your own code.
- [Architecture](https://docs.hrns.dev/internals/architecture.md): Understand how the current hrns runtime is assembled and where each package fits.
- [Quickstart](https://docs.hrns.dev/quickstart.md): Run the bundled hrns TUI, connect it to a model provider, and send your first tool-using prompt.
- [Package reference: loop](https://docs.hrns.dev/reference/loop.md): The agent loop, chunk model, and tool interface that drive hrns.
- [Package reference: main](https://docs.hrns.dev/reference/main.md): What the bundled hrns binary wires together at startup.
- [Package reference: openai](https://docs.hrns.dev/reference/openai.md): OpenAI-compatible request, response, and streaming primitives used by hrns.
- [Package reference: skills](https://docs.hrns.dev/reference/skills.md): Skill discovery, metadata loading, and the load_skill tool.
- [Package reference: tools](https://docs.hrns.dev/reference/tools.md): The bundled tool implementations shipped with hrns.
- [Package reference: tui](https://docs.hrns.dev/reference/tui.md): The terminal runner used by the bundled hrns binary.

## OpenAPI Specs

- [openapi](https://docs.hrns.dev/api-reference/openapi.json)

## Optional

- [GitHub](https://github.com/mishankov/hrns)