// proposed plugin flow
const run = await puts.capture({
  agent: "codex",
  consent: "current_chat",
});

await run.scan({
  redact: ["credentials", "selected"],
});

run.flag("weird");

await run.publish({
  visibility: "public",
  retention: "permanent",
});

tool.call("read_file");
tool.result({ status: "ok" });
model.output({ format: "text" });

// proposed plugin flow
const run = await puts.capture({
  agent: "codex",
  consent: "current_chat",
});

await run.scan({
  redact: ["credentials", "selected"],
});

run.flag("weird");

await run.publish({
  visibility: "public",
  retention: "permanent",
});

tool.call("read_file");
tool.result({ status: "ok" });
model.output({ format: "text" });

// proposed plugin flow
const run = await puts.capture({
  agent: "codex",
  consent: "current_chat",
});

await run.scan({
  redact: ["credentials", "selected"],
});

run.flag("weird");

await run.publish({
  visibility: "public",
  retention: "permanent",
});

tool.call("read_file");
tool.result({ status: "ok" });
model.output({ format: "text" });

// proposed plugin flow
const run = await puts.capture({
  agent: "codex",
  consent: "current_chat",
});

await run.scan({
  redact: ["credentials", "selected"],
});

run.flag("weird");

await run.publish({
  visibility: "public",
  retention: "permanent",
});

tool.call("read_file");
tool.result({ status: "ok" });
model.output({ format: "text" });

100% opt in · pre-alpha · concept only · no live uploads

Publish what your agents actually did.

'puts is a free, open-source archive for opt-in AI agent logs—a public record of how models and tools behave in the wild.

Join waitlist View source ↗

planned protocoleffect

/puts allow: review this chat
/puts flag weird: add context
all_chats = true: scan + publish

From run to record.

The plugin stays in the background. The decision to publish stays with the person running it.

1.0 · connect
Listen where agents already work.
Planned plugins will capture structured runs from Codex, Claude Code, OpenCode, Pi, and other agent workflows.
```
targets
codex        planned
claude-code  planned
opencode     planned
pi           planned
```
2.0 · allow
Nothing uploads by default.
Allow one conversation with /puts allow, or explicitly enable all-chat mode. Off remains the default.
```
mode       off
capture    none
upload     none
```
3.0 · review
Scan and redact locally.
Secrets and chosen redactions are handled before the log leaves the machine. A scan reduces risk; it cannot promise to recognize every sensitive value.
```
local scan
credentials  redacted
selected     redacted
remaining    previewed
```
4.0 · publish
Create a permanent public record.
Current-chat mode asks for one final confirmation. All-chat mode publishes automatically after a successful local scan.
```
visibility  public
identity    anonymous
retention   permanent
```
5.0 · learn
Read the work, not the demo.
Anyone can study how an agent reasoned, stalled, recovered, or surprised its user. Contributor-written flags add context without rewriting the run.
```
flags
weird
breakthrough
stuck
```

Consent is a mode with observable behavior, not a paragraph hidden in installation terms.

Mode	Trigger	Result
Off	Default	Nothing is captured or uploaded.
Current chat	`/puts allow`	Local preview and redaction, then final publish confirmation.
All chats	Explicit global setting	Local scan and redaction, followed by automatic permanent publication.

▲ irreversible operation

Public means permanent.

A published Puts log has no ordinary delete button. In all-chat mode, a log that passes the local scan becomes public automatically. Puts may still remove material for legal, safety, or abuse reasons.

Add your own marginalia.

Flags are contributor-written context for later readers, not a fixed taxonomy or a score.

/puts flag weird
/puts flag breakthrough
/puts flag stuck

The implementation will be public too.

The service, plugin protocol, and archive format will be free and open source. The code is the claim you can inspect now.

View source ↗

Codexplanned

Claude Codeplanned

OpenCodeplanned

Piplanned

Follow the build, not a launch countdown.

Join the private list if you build agents, study them, or simply want to see what Puts becomes.

Waitlist data is private and removable by request; that is separate from the permanent public-log policy. Contact petra@petras.page.

Publish what your agents actually did.

Listen where agents already work.

Nothing uploads by default.

Scan and redact locally.

Create a permanent public record.

Read the work, not the demo.

Public means permanent.

The implementation will be public too.

Follow the build, not a launch countdown.