# nolabs-ai/nono architecture

> Architecture diagram of the GitHub repository nolabs-ai/nono, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nolabs-ai/nono
- Repository: https://github.com/nolabs-ai/nono

## Overview

nono is an agent runtime security tool. Its main workflow is to select or compose a profile, review the resulting capabilities, then launch an agent command inside kernel-enforced isolation; optional proxying mediates network and credential access. Separate product branches provide tool sandboxes, trust verification, tamper-evident audit, rollback, and platform services. The graph uses README capability statements and SOURCE INDEX references for relationships; unsampled modules are represented only where the README establishes their role.

Main entry points: [`crates/nono-cli/src/launch_runtime.rs`](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/launch_runtime.rs) (Launch runtime), [`crates/nono-proxy/src/server.rs`](https://github.com/nolabs-ai/nono/blob/main/crates/nono-proxy/src/server.rs) (Network proxy), [`crates/nono-cli/src/cli.rs`](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/cli.rs) (CLI commands), [`crates/nono-cli/src/platform_client.rs`](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/platform_client.rs) (Platform client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_run["Command runtime"]
  node_cli["CLI commands<br/>[cli.rs]"]
  node_launch["Launch runtime<br/>[launch_runtime.rs]"]
end

subgraph group_policy["Policy and profiles"]
  node_profiles["Profile system<br/>[mod.rs]"]
  node_config["Config and policy<br/>[mod.rs]"]
end

subgraph group_security["Enforcement and proxy"]
  node_sandbox["Sandbox engine<br/>[linux.rs]"]
  node_capabilities["Capabilities<br/>[capability.rs]"]
  node_toolbox["Tool sandbox"]
  node_proxy["Network proxy<br/>[server.rs]"]
  node_proxyconfig["Proxy configuration<br/>[config.rs]"]
  node_credentials["Phantom credentials<br/>[token.rs]"]
end

subgraph group_assurance["Trust and recovery"]
  node_trust["Supply-chain trust"]
  node_audit["Cryptographic audit<br/>[audit_client.rs]"]
  node_rollback["File rollback<br/>[snapshot.rs]"]
end

subgraph group_platform["Platform services"]
  node_platform["Platform client<br/>[platform_client.rs]"]
  node_oauth["OAuth and DPoP<br/>[client.rs]"]
end

node_user(("Agent operator"))
node_agent(("Agent process"))
node_network(("External services"))

node_user -->|"invokes"| node_cli
node_cli -->|"dispatches"| node_launch
node_launch -->|"loads"| node_profiles
node_launch -->|"resolves policy"| node_config
node_launch -->|"prepares isolation"| node_sandbox
node_sandbox -->|"enforces"| node_capabilities
node_launch -->|"launches"| node_agent
node_profiles -->|"defines access"| node_capabilities
node_launch -.->|"starts optional mediation"| node_proxy
node_proxy -->|"loads"| node_proxyconfig
node_proxy -->|"resolves tokens"| node_credentials
node_proxy -->|"forwards traffic"| node_network
node_launch -.->|"enables isolated tools"| node_toolbox
node_launch -->|"verifies inputs"| node_trust
node_launch -.->|"records sessions"| node_audit
node_launch -.->|"tracks changes"| node_rollback
node_cli -->|"uses platform commands"| node_platform
node_platform -->|"uses OAuth"| node_oauth
node_platform -.->|"calls platform"| node_network

click node_cli "https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/cli.rs"
click node_launch "https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/launch_runtime.rs"
click node_sandbox "https://github.com/nolabs-ai/nono/blob/main/crates/nono/src/sandbox/linux.rs"
click node_capabilities "https://github.com/nolabs-ai/nono/blob/main/crates/nono/src/capability.rs"
click node_profiles "https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/profile/mod.rs"
click node_config "https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/config/mod.rs"
click node_toolbox "https://github.com/nolabs-ai/nono/tree/main/crates/nono-cli/src/tool-sandbox"
click node_proxy "https://github.com/nolabs-ai/nono/blob/main/crates/nono-proxy/src/server.rs"
click node_proxyconfig "https://github.com/nolabs-ai/nono/blob/main/crates/nono-proxy/src/config.rs"
click node_credentials "https://github.com/nolabs-ai/nono/blob/main/crates/nono-proxy/src/token.rs"
click node_trust "https://github.com/nolabs-ai/nono/tree/main/crates/nono/src/trust"
click node_audit "https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/audit_client.rs"
click node_rollback "https://github.com/nolabs-ai/nono/blob/main/crates/nono/src/undo/snapshot.rs"
click node_platform "https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/platform_client.rs"
click node_oauth "https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/platform_oauth/client.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_launch toneBlue
class node_profiles,node_config toneAmber
class node_sandbox,node_capabilities,node_toolbox,node_proxy,node_proxyconfig,node_credentials toneMint
class node_trust,node_audit,node_rollback toneRose
class node_platform,node_oauth,node_user,node_agent,node_network toneIndigo
```

## Components

### Command runtime

- [CLI commands](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/cli.rs): `crates/nono-cli/src/cli.rs`
- [Launch runtime](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/launch_runtime.rs): `crates/nono-cli/src/launch_runtime.rs`

### Policy and profiles

- [Profile system](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/profile/mod.rs): `crates/nono-cli/src/profile/mod.rs`
- [Config and policy](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/config/mod.rs): `crates/nono-cli/src/config/mod.rs`

### Enforcement and proxy

- [Sandbox engine](https://github.com/nolabs-ai/nono/blob/main/crates/nono/src/sandbox/linux.rs): `crates/nono/src/sandbox/linux.rs`
- [Capabilities](https://github.com/nolabs-ai/nono/blob/main/crates/nono/src/capability.rs): `crates/nono/src/capability.rs`
- [Tool sandbox](https://github.com/nolabs-ai/nono/tree/main/crates/nono-cli/src/tool-sandbox): `crates/nono-cli/src/tool-sandbox`
- [Network proxy](https://github.com/nolabs-ai/nono/blob/main/crates/nono-proxy/src/server.rs): `crates/nono-proxy/src/server.rs`
- [Proxy configuration](https://github.com/nolabs-ai/nono/blob/main/crates/nono-proxy/src/config.rs): `crates/nono-proxy/src/config.rs`
- [Phantom credentials](https://github.com/nolabs-ai/nono/blob/main/crates/nono-proxy/src/token.rs): `crates/nono-proxy/src/token.rs`

### Trust and recovery

- [Supply-chain trust](https://github.com/nolabs-ai/nono/tree/main/crates/nono/src/trust): `crates/nono/src/trust`
- [Cryptographic audit](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/audit_client.rs): `crates/nono-cli/src/audit_client.rs`
- [File rollback](https://github.com/nolabs-ai/nono/blob/main/crates/nono/src/undo/snapshot.rs): `crates/nono/src/undo/snapshot.rs`

### Platform services

- [Platform client](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/platform_client.rs): `crates/nono-cli/src/platform_client.rs`
- [OAuth and DPoP](https://github.com/nolabs-ai/nono/blob/main/crates/nono-cli/src/platform_oauth/client.rs): `crates/nono-cli/src/platform_oauth/client.rs`

### Other components

- **Agent operator**
- **Agent process**
- **External services**

## Connections

- Agent operator → CLI commands: invokes (evidence: `README.md`)
- CLI commands → Launch runtime: dispatches (evidence: `crates/nono-cli/src/main.rs`)
- Launch runtime → Profile system: loads (evidence: `crates/nono-cli/src/launch_runtime.rs`)
- Launch runtime → Config and policy: resolves policy (evidence: `crates/nono-cli/src/launch_runtime.rs`)
- Launch runtime → Sandbox engine: prepares isolation (evidence: `crates/nono-cli/src/launch_runtime.rs`)
- Sandbox engine → Capabilities: enforces (evidence: `crates/nono/src/sandbox/linux.rs`)
- Launch runtime → Agent process: launches (evidence: `README.md`)
- Profile system → Capabilities: defines access (evidence: `README.md`)
- Launch runtime → Network proxy: starts optional mediation
- Network proxy → Proxy configuration: loads (evidence: `crates/nono-proxy/src/server.rs`)
- Network proxy → Phantom credentials: resolves tokens (evidence: `crates/nono-proxy/src/server.rs`)
- Network proxy → External services: forwards traffic (evidence: `crates/nono-proxy/src/server.rs`)
- Launch runtime → Tool sandbox: enables isolated tools
- Launch runtime → Supply-chain trust: verifies inputs (evidence: `crates/nono-cli/src/launch_runtime.rs`)
- Launch runtime → Cryptographic audit: records sessions
- Launch runtime → File rollback: tracks changes
- CLI commands → Platform client: uses platform commands (evidence: `crates/nono-cli/src/platform_client.rs`)
- Platform client → OAuth and DPoP: uses OAuth (evidence: `crates/nono-cli/src/platform_client.rs`)
- Platform client → External services: calls platform
