๐Ÿ” Secure Identity Layer

Every AI agent
needs an identity.

AgentDNAI gives every AI agent a verifiable digital identity, scoped permissions, encrypted credentials, revocable access and a clear audit trail.

> Identity ยท Authorization ยท Audit โ€” unified for AI agents

Deny by default
Temporary tokens
Full audit trail
agentdnai check
$ agentdnai check hermes-auditor github.repo.read \
  --resource github.com/org/repo

AgentDNAI Authorization Check

  Agent:   hermes-auditor
  Action:  github.repo.read
  Resource: github.com/org/repo

  Decision: ALLOW โœ“
  Reason:  Explicit permission found.
  Expires: 2026-06-30 23:59:59 UTC

Identity, permissions and trust for AI agents.

A complete identity and authorization layer for the age of AI agents.

Agent Identity

Unique URI, RSA-PSS key pair, and lifecycle status for every agent. Know exactly who is acting.

Scoped Permissions

47 granular permissions across 9 categories. ALLOW, DENY, or require human approval per action.

Temporary Tokens

Short-lived, SHA-256 hash-stored tokens. TTL from 60 seconds to 24 hours. Raw tokens never stored.

Audit Trail

Hash-chained, append-only log of every decision. Tamper-evident with chain integrity verification.

Major new features and improvements

The v0.2 release brings authentication, organizations, health checks, risk scoring, and much more.

User Authentication

JWT + bcryptjs authentication with sessions, login, register, and logout.

Organization Management

Multi-tenant orgs with roles: OWNER, ADMIN, SECURITY_MANAGER, DEVELOPER, VIEWER.

Ed25519 Cryptographic Identity

Every agent gets an Ed25519 key pair for verifiable identity and challenge-response.

HMAC-SHA256 Token Hashing

Tokens hashed with pepper. Raw tokens never stored. Timing-safe comparison.

Agent Health Checks

Real-time health monitoring for every agent with status and uptime tracking.

Risk Scoring (7-Factor)

Comprehensive 7-factor risk assessment on a 0โ€“100 scale per agent.

Approval Workflow

Request, approve, reject workflow for actions requiring human review.

17+ Dashboard Views

Comprehensive dashboard with agents, audit, policies, playground, compare, heatmap, and more.

Real-Time Event Streaming

WebSocket + SSE live security event feed with pause/resume and live indicators.

47
Permission Scopes
9
Categories
10
Templates
0
Implicit Grants

Up and running in 2 minutes

Clone, install, push the schema, and start the dev server. That's it.

1

Clone the repository

Get the code on your machine.

git clone https://github.com/smouj/agentdnai.git
cd agentdnai
2

Install dependencies

Using Bun (recommended) or npm.

bun install
3

Set up environment

Copy the example env file (defaults work for development).

cp .env.example .env
4

Initialize the database

Push the Prisma schema to create the SQLite database.

bun run db:push
5

Start the development server

Open http://localhost:3000 in your browser.

bun run dev

37+ API Endpoints

Full REST API for agent management, authorization, and audit.

MethodEndpointDescription
POST/api/agentsCreate a new agent
GET/api/agentsList agents (search/filter)
GET/api/agents/{id}Get agent details
POST/api/agents/{id}/revokeRevoke agent identity
POST/api/agents/{id}/permissionsGrant permission
POST/api/tokens/issueIssue temporary token
POST/api/authz/checkCheck authorization
POST/api/authz/batch-checkBatch authorization check
GET/api/auditList audit events
GET/api/audit/verifyVerify hash chain
GET/api/exportExport all data as JSON
GET/api/events/streamReal-time SSE event feed
POST/api/auth/registerRegister new account
POST/api/auth/loginLogin with email/password
POST/api/auth/logoutInvalidate session
GET/api/agents/{id}/riskAgent risk score (7-factor)
GET/api/agents/{id}/healthAgent health check
POST/api/agents/{id}/approveApprove pending action
GET/api/statsPlatform statistics
GET/api/activityActivity heatmap data
GET/api/exportExport all data as JSON
POST/api/importImport data from JSON

See README.md for the complete API reference.

No more anonymous agents.

Know every agent. Control every action. Audit every decision.

โšก Get Started on GitHub