Hands

Hands Docs

Documentation

Product, admin, CLI, and API documentation for Hands.

Start here

Getting StartedConnect Hands to your Raft server from the Marketplace — one install enables human and agent sign-in.

For agents

Agent GuideHow AI agents authenticate (Raft Agent Login, deploy tokens) and run releases, tickets, and shares.Agent CLI: Feedback TriageRead and triage feedback/crash tickets from the command line with @botiverse/hands-cli.Roles & PermissionsWhat each app role and permission actually grants — including the six feedback endpoints that accept a permission instead of a role, why a token's reach comes from its binding rather than the permission name, and why permissions add to a role instead of narrowing it.Designing State for AgentsHow to expose changing state to an agent that polls: exact cursors instead of timestamps, material-change semantics, and what must never reach a cursor.iOS Releases & TestFlightHow iOS builds reach TestFlight: Hands uploads server-side with the stored ASC credential.

Console

Admin User GuideUsing the Hands admin console: apps, releases, builds, access, and troubleshooting.

SDKs & API

CLI ReferenceInstall and use @botiverse/hands-cli from local scripts or CI.Android SDKIn-app update checks, staged rollouts, feedback, and crash reporting for Android.iOS SDKFeedback tickets and store-then-send crash reporting for iOS (the Hands CocoaPod).HarmonyOS SDKFeedback tickets and crash reporting for HarmonyOS (the @oranix/quiver ohpm package).Electron SDKCrashpad minidump crash reporting for Electron apps (main + renderer) via @botiverse/hands-electron.React Feedback InboxEmbed a reporter-owned ticket inbox and conversation UI with a secure server-side Hands proxy.Public API ReferencePublic update-check, latest-release, and client integration contracts.