todos.md

todos.md documentation

Run shared task work with agents.

Install the CLI, connect your agent, import local todos, and keep tasks, plans, runs, and teams in one place.

Artifacts

Artifacts are files produced by hosted runs. Logs, receipts, and generated files are kept separate from task text.

Folder contract

.todos/
  exports/
    <run-id>/
      manifest.json
      receipt.json
      generated-files...
  runs/
    <run-id>/
      metadata.json
      logs.jsonl

Manifest fields

FieldPurpose
runIdStable id for the run.
capabilityThe hosted capability that ran.
createdAtCompletion timestamp.
inputsSanitized input metadata.
artifactsRelative paths, media types, and descriptions.
receiptBilling result when a paid run is involved.

Download behavior

Worker writes private storage

Remote workers upload artifacts and record checksums.

API controls access

The API signs or proxies reads only for the owning organization.

CLI exports files

The CLI downloads files under .todos/exports/<run-id>/.

bun install -g @hasna/todos