# hasp

> Local secret broker for coding-agent and app workflows.

Docs root: https://gethasp.com/docs/
Version: 0.1.39
GitHub: https://github.com/gethasp/hasp
Changelog: /docs/changelog/

## Recommended Reading

### Start
- [Overview](https://gethasp.com/docs/overview/): What HASP is, what ships in the public repo, and what the local broker does.
- [Mental model](https://gethasp.com/docs/mental-model/): How to think about vaults, repo boundaries, consumers, grants, sessions, audit, and redaction.
- [Value-free manifests](https://gethasp.com/docs/value-free-manifests/): The committed .hasp.manifest.json contract for requirements, targets, examples, delivery, and safety rules.
- [Quickstart](https://gethasp.com/docs/quickstart/): The shortest safe path to a working local HASP install.
- [Install](https://gethasp.com/docs/install/): Homebrew install, upgrade, uninstall, packaged releases, and source builds.
- [After Install](https://gethasp.com/docs/after-homebrew/): The common first-run path after installing HASP.


### Operate
- [Command guide](https://gethasp.com/docs/command-guide/): What each HASP command does, when to use it, and how it compares to nearby commands.
- [Operator Guide](https://gethasp.com/docs/operator-guide/): Environment variables, repo guardrails, audit, backup, and safe local operation.
- [Repo targets](https://gethasp.com/docs/repo-targets/): Value-free repo requirements, target-scoped delivery, examples, and app/MCP target behavior.


### Agents
- [Agent Profiles](https://gethasp.com/docs/agent-profiles/): First-class support profile expectations and the generic broker path.
- [Codex CLI](https://gethasp.com/docs/agent-profiles/codex-cli/): Connect Codex CLI through HASP as a brokered MCP surface.
- [Claude Code](https://gethasp.com/docs/agent-profiles/claude-code/): Connect Claude Code through HASP as a brokered MCP surface.
- [Cursor](https://gethasp.com/docs/agent-profiles/cursor/): Connect Cursor through HASP as a brokered MCP surface.
- [Aider](https://gethasp.com/docs/agent-profiles/aider/): Connect Aider through HASP as a brokered MCP surface.
- [Hermes](https://gethasp.com/docs/agent-profiles/hermes/): Connect Hermes through HASP as a brokered MCP surface.
- [OpenClaw](https://gethasp.com/docs/agent-profiles/openclaw/): Connect OpenClaw through HASP as a brokered MCP surface.
- [Generic Broker Path](https://gethasp.com/docs/agent-profiles/generic/): Use HASP with CLI- or MCP-capable agents that do not have first-class profiles yet.


### Release
- [Changelog](https://gethasp.com/docs/changelog/): Public release notes for shipped HASP versions.
- [Release distribution](https://gethasp.com/docs/release-distribution/): Release assets, hosted mirrors, checksums, signatures, and Homebrew formula updates.
- [Install and release](https://gethasp.com/docs/install-and-release/): Operator-facing release verification and install details.


### Reference
- [Glossary](https://gethasp.com/docs/glossary/): HASP vocabulary used across CLI help, docs, audit events, and errors.
- [CLI reference](https://gethasp.com/docs/cli-reference/): Exact help output generated by the installed hasp binary.
- [Errors](https://gethasp.com/docs/error-codes/): Error messages, stable exit buckets, JSON error codes, hints, and recovery guidance.


## Agent Notes

- HASP keeps named secrets in a local encrypted vault.
- Repo bindings define where secrets can be used.
- Grants are short-lived and scoped to a run, session, or window.
- Agents should use brokered references and metadata, not raw secret values.
- Use `/llms-full.txt` for the full public documentation bundle.