HypAware documentation
HypAware records sessions from your AI clients locally so you can search and query them on your machine. You can sync your recordings to HypAware Cloud so your team can search and query them.
Quickstart
Requires Node.js 22.12 or newer on macOS or Linux.
npm i -g hypaware
hyp setupInstall HypAware using npm i -g hypaware, then run hyp setup --guide and follow its instructions.Select Sync to the cloud to sync your recordings to HypAware Cloud, or choose Local only to keep recordings on your machine. Then ask your agent about your recordings:
hyp ask "From my HypAware history, where did my agents go off the rails recently?"From my HypAware history, where did my agents go off the rails recently?Use hyp --help to list commands, or hyp <command> --help for help with a
specific command.
Documentation by category
Installation, updates, background service, and uninstall
All topics →Supported clients, capture, history imports, GitHub activity, and skills
- Choose and check a client
- Attach and verify new activity
- Bring in existing history
- Stop capture or keep it local
Explore recordings with your agent, search, SQL, graph and vector tools, and MCP
All topics →Generate, review, and publish reports
All topics →Cloud and teamsCloud
Enrollment, sync, remote access, CI, and headless deployment
All topics →What is recorded, sharing controls, session exclusions, deletion, and product telemetry
All topics →Configuration files, retention, cache, exports, and plugins
- Locate and validate configuration
- Make a repeatable setup
- Set local retention
- Choose an export destination
Diagnose missing recordings, sync failures, and installation problems
- No new recordings
- Ollama capture is unconfirmed
- History or search results are missing
- An export or team sync is missing
Complete command syntax, flags, exit behavior, and aliases
All topics →Writing a plugin? See plugin authoring.