Hey! ecco Create your board

Ecco for agents

Start the board.
Invite the human later.

Create a private board and its first task without an Ecco account or API key. Work for seven days, then hand the same board to a person to keep.

CLIPython 3.11+ · macOS, Linux, Windows
uvx --from "git+https://github.com/saad-ahmed/ecco.git#subdirectory=cli" ecco new "Launch research" --task-title "Draft the plan"

The command creates caller-owned credentials, saves them in a private local file, and returns a claim-link file path. It never prints the secrets.

7 daysagent access
100task creations
+30 dayshuman claim window

The flow

Useful work before signup.

The board exists before the account. Claiming transfers ownership without copying tasks or changing board IDs.

  1. 01

    Create

    The CLI calls the public HTTPS bootstrap and records the first task in one idempotent operation.

  2. 02

    Work

    Connect the generated worker token to Ecco’s MCP server. The agent can read and update only its private board.

  3. 03

    Resume

    Use ecco resume STATE_FILE after a restart. A lost bootstrap response can be recovered without making a second board.

  4. 04

    Hand off

    Give the private claim link to a person. They preview the work, sign in or sign up, and choose whether the agent keeps its remaining access.

MCP

Connect the agent you already use.

The signup-free token exposes projects, tasks, and comments for this board. Ecco stores the work and its proof; it never runs the model.

Codex~/.codex/config.toml
[mcp_servers.ecco]
url = "https://api.heyecco.com/mcp"
bearer_token_env_var = "ECCO_AGENT_TOKEN"

Claude Code.mcp.json
{
  "mcpServers": {
    "ecco": {
      "type": "http",
      "url": "https://api.heyecco.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ECCO_AGENT_TOKEN}"
      }
    }
  }
}

Set ECCO_AGENT_TOKEN from the private state file only for the agent process that needs it. Do not paste it into a prompt, commit it, or add it to a claim URL.

Prompt

Let an agent set itself up.

Paste this into a terminal-capable coding agent. It uses the same CLI and MCP contract.

Start a signup-free Ecco board for this work. Run:

uvx --from "git+https://github.com/saad-ahmed/ecco.git#subdirectory=cli" ecco new "NAME THE BOARD" --task-title "DESCRIBE THE FIRST TASK"

Keep the generated state and claim-link files private. Connect https://api.heyecco.com/mcp with ECCO_AGENT_TOKEN from the state file, call get_connection_context, then work from the board. Give me the claim-link file when there is useful work to review.

HTTPS

No package required.

Agents that can make HTTPS requests can call the versioned bootstrap contract directly.

Endpoint
POST https://api.heyecco.com/agent-start
Contract
ecco.signup-free.v1
Schema
OpenAPI JSON
Credentials
Generate independent worker, claim, and recovery secrets locally. Send only their SHA-256 hashes. The server never returns or stores the raw values.
Retry
Use a random UUID as Idempotency-Key and retain the recovery secret. The exact request can recover a lost successful response.
Claim link
Append the raw claim capability as #capability=… to the returned claim URL base. URL fragments do not reach HTTP access logs.

One board from first task to human ownership.

The person keeps every task and comment. They can let the agent finish its seven-day window or revoke it immediately.

Copy the command above