> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kavachos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# KavachOS vs Hanko

> KavachOS versus Hanko across passkey support, OAuth providers, agent identity, MCP OAuth, RBAC, and licensing. Includes a clear decision framework for each tool.

Hanko is built around one idea: passkeys should be the default, not the fallback. It's a focused library with a Go backend, official TypeScript bindings, and an AGPL license. If passkeys are your entire auth surface and you have zero agent workloads, it's worth a serious look.

KavachOS includes passkey support as one method among many. The bigger difference is what happens after the human authenticates: KavachOS was designed for the agent layer that comes next.

A migration guide from Hanko is coming soon.

## Feature matrix

| Capability            | KavachOS                                     | Hanko                        |
| --------------------- | -------------------------------------------- | ---------------------------- |
| License               | MIT                                          | AGPL (backend), MIT (JS SDK) |
| Primary focus         | Agent-first auth SDK                         | Passkey-first auth           |
| TypeScript SDK        | Yes, first-party                             | Yes, first-party             |
| Named OAuth providers | 24                                           | \~3 (Google, Apple, GitHub)  |
| Passkey support       | Yes                                          | Yes, core focus              |
| MCP OAuth 2.1 server  | Built in                                     | Not shipped                  |
| Agent identity        | First-class `AgentIdentity` entity           | Not shipped                  |
| RBAC / permissions    | Unified RBAC + ABAC + ReBAC                  | Not shipped                  |
| Ephemeral sessions    | Built in with auto-expiry and audit grouping | Not shipped                  |
| Edge runtime          | Web Crypto throughout                        | Go backend required          |
| Self-hostable         | Yes                                          | Yes                          |

## Pick KavachOS if

* You need more than passkeys: OAuth providers, agent identity, or a policy engine.
* You're building AI-powered products where agents need their own auth layer.
* You want a permissive MIT license for the full stack, not just the client SDK.

## Pick Hanko if

* You want the smallest possible passkey-only library with a tight scope.
* You have no agent story and passkey-first is exactly the feature you need.
* You're comfortable with AGPL for your backend auth service.

Hanko does one thing well. KavachOS does more, which is a tradeoff in either direction.
