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. Bring your own cloud (required to send files)

To send files in a decision, point Pileless at your own Cloudflare R2 bucket. Your documents go straight there and never sit on our infrastructure. Text-only decisions need no bucket, so you can start without this and add it the first time your agent sends a file. 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