Get started

From zero to your agent handing you decisions in about five minutes.

1. Create your workspace

Sign in to Pileless and you've got a workspace — the home for your piles and the place your agent's decisions land. Under Settings → API keys, mint a workspace key (ak_…); your agent uses it to authenticate.

2. Connect an agent

Wire your agent to Pileless over MCP. Pick your tool:

Claude Code

Add the MCP server to your config.

Guide →

Codex

Register it in config.toml.

Guide →

Then tell the agent when to pile — drop this in its instructions:

When you're about to send, post, publish, refund, deploy, or commit
something — or you have 2+ options for me to choose from — create a
Pileless pile and wait for my decision instead of guessing.

3. (Optional) Bring your own cloud

If you're handling sensitive files, point Pileless at your own Cloudflare R2 bucket so documents never sit on our infrastructure. Full R2 walkthrough →

4. Clear your first pile

Ask your agent to "create a test pile with three options for me to pick from, and give me the link." Open the link — that's your inbox. Each tile is a decision; act in place:

  • Approve / Reject / Use this — right on the tile.
  • Pick one / rank — choose or drag the options.
  • Add a comment — it travels back to the agent with your decision.

The moment you decide, the agent gets the structured result and carries on.

Working the inbox

  • Zoom: Ctrl + scroll to go from a dense list, to cards, to a full-page reader.
  • Arrange: by Urgency (default — blocking on top, then fastest→slowest), Sender, or Time. Or drag items into your own order.
  • Keyboard: arrow keys move between tiles; act without leaving the keyboard.
  • Resize the preview panel by dragging its edge.

Connect Claude Code →   Connect Codex

DRAFT · for review