# openserv-team

Four-agent workspace for building on the OpenServ platform.

| Agent       | Role                                                           | Skills                 |
| ----------- | -------------------------------------------------------------- | ---------------------- |
| `scout`     | Monitors the Ideaboard for ideas and bounties, reports to lead | `openserv-labs/skills` |
| `lead`      | Coordinates the team, reviews ideas, assigns work              | `openserv-labs/skills` |
| `agent-dev` | Builds and deploys OpenServ agents using the SDK               | `openserv-labs/skills` |
| `launcher`  | Launches ERC-20 tokens via the OpenServ Launch API             | `openserv-labs/skills` |

The scout runs on a cron schedule (every 4 hours) to fetch new ideas from the Ideaboard and share them with the lead. The lead then delegates to agent-dev or launcher as needed.

## Usage

```bash
ai-cofounder start --office openserv-team
```

The office boots without any pre-set environment variables. The first time you start it the setup wizard will prompt you in the terminal to log in with OpenAI Codex OAuth (ChatGPT Plus/Pro with Codex access) — that covers all four agents. If you prefer a different provider, pick "Use a different provider" in the wizard and point the team at Anthropic / OpenAI API key / etc.

## Environment — optional for OpenServ platform calls

The agents' prompts instruct them to authenticate with the OpenServ platform using either `OPENSERV_API_KEY` or a `WALLET_PRIVATE_KEY` via the SIWE (sign-in with Ethereum) flow. Neither is required for the agents to boot — but without them the agents cannot actually talk to the OpenServ API, launch tokens, or fetch Ideaboard entries.

Put whatever you have in `.env` in the directory where you run `ai-cofounder`:

```env
# Preferred — a direct OpenServ key
OPENSERV_API_KEY=

# Fallback — an EVM wallet key used for SIWE
WALLET_PRIVATE_KEY=
```

The agents read these at runtime from their own process environment; they do not need to be declared in `office.yaml`.