# atuldhull/g-a-h architecture

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

- Interactive diagram: https://gitdiagram.com/atuldhull/g-a-h
- Repository: https://github.com/atuldhull/g-a-h

## Overview

Crocodile is described as a planned Python terminal coding agent, not an implemented runtime in this repository. Its intended user-to-result flow and major design areas are represented from the README’s architecture map. The available evidence does not expose runtime code or detailed flows, so most subsystem links are omitted rather than inferred.

Main entry points: [`docs/architecture/01-overview.md`](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/01-overview.md) (Crocodile agent), [`docs/architecture/10-evaluation.md`](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/10-evaluation.md) (Task evaluation), [`docs/architecture/06-budget-and-reliability.md`](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/06-budget-and-reliability.md) (Budget and reliability), [`docs/architecture/05-security-model.md`](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/05-security-model.md) (Security approvals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent["Coding agent"]
  node_agent["Crocodile agent<br/>[01-overview.md]"]
  node_cli["CLI experience<br/>[11-cli-ux.md]"]
  node_runtime["Runtime flows"]
end

subgraph group_controls["Policy and efficiency"]
  node_token["Token and accuracy"]
  node_budget["Budget and reliability"]
  node_security["Security approvals"]
  node_confidential["Confidential mode"]
  node_state[("SQLite state<br/>[04-data-model.md]")]
end

subgraph group_evaluation["Integrations and evaluation"]
  node_gateway{{"Bifrost gateway"}}
  node_search{{"Tavily search"}}
  node_benchmark["Task evaluation<br/>[10-evaluation.md]"]
end

node_user(("Terminal user"))
node_repo["Code repository"]
node_model{{"AI model"}}
node_baseline["mini-swe-agent"]

node_user -.->|"uses terminal"| node_agent
node_agent -.->|"works on"| node_repo
node_agent -.->|"requests work"| node_model
node_agent -.->|"enforces budget"| node_budget
node_agent -.->|"enforces rules"| node_security
node_agent -.->|"applies privacy"| node_confidential
node_benchmark -->|"paired comparison"| node_baseline
node_benchmark -->|"uses same model"| node_model
node_benchmark -->|"uses same gateway"| node_gateway

click node_agent "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/01-overview.md"
click node_cli "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/11-cli-ux.md"
click node_runtime "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/03-runtime-flows.md"
click node_token "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/08-token-and-accuracy-engine.md"
click node_budget "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/06-budget-and-reliability.md"
click node_security "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/05-security-model.md"
click node_confidential "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/07-confidential-mode.md"
click node_state "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/04-data-model.md"
click node_gateway "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/09-bifrost-and-tavily.md"
click node_search "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/09-bifrost-and-tavily.md"
click node_benchmark "https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/10-evaluation.md"

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_agent,node_cli,node_runtime,node_user toneBlue
class node_token,node_budget,node_security,node_confidential,node_state toneAmber
class node_gateway,node_search,node_benchmark toneMint
class node_repo,node_model,node_baseline toneIndigo
```

## Components

### Coding agent

- [Crocodile agent](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/01-overview.md): `docs/architecture/01-overview.md`
- [CLI experience](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/11-cli-ux.md): `docs/architecture/11-cli-ux.md`
- [Runtime flows](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/03-runtime-flows.md): `docs/architecture/03-runtime-flows.md`

### Policy and efficiency

- [Token and accuracy](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/08-token-and-accuracy-engine.md): `docs/architecture/08-token-and-accuracy-engine.md`
- [Budget and reliability](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/06-budget-and-reliability.md): `docs/architecture/06-budget-and-reliability.md`
- [Security approvals](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/05-security-model.md): `docs/architecture/05-security-model.md`
- [Confidential mode](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/07-confidential-mode.md): `docs/architecture/07-confidential-mode.md`
- [SQLite state](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/04-data-model.md): `docs/architecture/04-data-model.md`

### Integrations and evaluation

- [Bifrost gateway](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/09-bifrost-and-tavily.md): `docs/architecture/09-bifrost-and-tavily.md`
- [Tavily search](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/09-bifrost-and-tavily.md): `docs/architecture/09-bifrost-and-tavily.md`
- [Task evaluation](https://github.com/atuldhull/g-a-h/blob/main/docs/architecture/10-evaluation.md): `docs/architecture/10-evaluation.md`

### Other components

- **Terminal user**
- **Code repository**
- **AI model**
- **mini-swe-agent**

## Connections

- Terminal user → Crocodile agent: uses terminal
- Crocodile agent → Code repository: works on
- Crocodile agent → AI model: requests work
- Crocodile agent → Budget and reliability: enforces budget
- Crocodile agent → Security approvals: enforces rules
- Crocodile agent → Confidential mode: applies privacy
- Task evaluation → mini-swe-agent: paired comparison (evidence: `README.md`)
- Task evaluation → AI model: uses same model (evidence: `README.md`)
- Task evaluation → Bifrost gateway: uses same gateway (evidence: `README.md`)