OXYGENHUB

README: the agents section in shorter sentences, the command as an example 37f1914b62a8

As the review of proposal #70 suggested: "attributed to you" rather
than "authored by you", "has approved", and the delegation command on
a line of its own as an example. refs #70
Author
Andy McCall @andymccall <[email protected]>
When
· 2026-10-04 19:07 UTC
Signature
✔ signed by Andy McCall
Hash
37f1914b62a82076d723fc4ece9a6ab745908f160d5842dfecf8d5e6bf307ae4
Depends on
1f53d5b91eb5 648724d8e0de d02e545dc265
Depended on by
91334b7fa574
In bookmarks
agents-in-readme bare-hashes carried-not-removed carry-identical doctor-trust identical-sides keyless-tags main merge-remote-bookmark only-help-103 paths-for-resolutions-and-amend push-notes show-stat subrepo-pin-state switch-says
In tags
v0.10.0 v0.11.0 v0.4.1 v0.4.2 v0.4.3 v0.4.4 v0.4.5 v0.4.6 v0.5.0 v0.5.1 v0.6.0 v0.7.0 v0.8.0 v0.9.0
Edits
3 atoms, 0 tree operations, 1 file

Browse the tree at this change

hide whitespace changes
modified README.md +9 −1
… 
5 unchanged lines
6 6 

    

  
    

      7
      7
       
      
## Working with agents

    

  
    

      8
      8
       
      

    

  
    

      9
      
      -
      
An AI agent works in Oxygen under its own key, delegated by you for a scope and a time (`oxy identity delegate add agent.identity --scope changes --expires 8h`): every change it makes is authored by you and signed by the agent, so `oxy log`, `oxy verify` and the hub show *who did the work* ("Andy McCall · via Claude Code") and a policy can require that a person approved it. See [docs/ai_native_agent_workflows.md](docs/ai_native_agent_workflows.md) for the design and [docs/guide.md](docs/guide.md) §9 for the setup.

    

  
    

      
      9
      +
      
An AI agent works in Oxygen under a key of its own, which you delegate to for a scope and a time. For example:

    

  
    

      10
      10
       
      

    

  
    

      
      11
      +
      
```

    

  
    

      
      12
      +
      
oxy identity delegate add agent.identity --scope changes --expires 8h

    

  
    

      
      13
      +
      
```

    

  
    

      
      14
      +
      

    

  
    

      
      15
      +
      
Every change the agent makes is attributed to you and signed by the agent. `oxy log`, `oxy verify` and the hub therefore show who did the work, such as "Andy McCall · via Claude Code", and a policy can require that a person has approved it before it lands.

    

  
    

      
      16
      +
      

    

  
    

      
      17
      +
      
See [docs/ai_native_agent_workflows.md](docs/ai_native_agent_workflows.md) for the design and [docs/guide.md](docs/guide.md) §9 for the setup.

    

  
    

      
      18
      +
      

    

  
    

      11
      19
       
      
## What is different

    

  
    

      12
      20
       
      

    

  
    

      13
      21
       
      
- **History is a set of changes, not a chain of snapshots.** A change records what it did to identified lines and tree nodes and which earlier changes it depends on. Changes that do not depend on each other commute, so there are no merge commits and rebasing independent work rewrites nothing.

    

  
    

      
      
      …
      
63 unchanged lines