exe.dev

Speko works on exe.dev three ways: teach Shelley the Speko skills, launch the voice-agent starter into a fresh VM with one click, or connect the hosted MCP server to the Claude Code and Codex agents preinstalled on every VM.

Teach Shelley the Speko skills

Shelley discovers Agent Skills from ~/.config/agents/skills and from .skills/ directories inside a repo. Install both Speko skills on a VM:

rm -rf /tmp/speko-skills \
  && git clone --depth 1 https://github.com/SpekoAI/agent-skills /tmp/speko-skills \
  && mkdir -p ~/.config/agents/skills \
  && cp -r /tmp/speko-skills/skills/* ~/.config/agents/skills/

speko-voice-app teaches Shelley to build against the Speko API — keys, the dial/poll/report loop, the speech endpoints, the traps. speko-phone-call teaches it to place one confirmed phone call and read back the transcript. To pin a skill to a single project instead, copy its folder into the repo's .skills/ directory — every VM launched from that repo gets it automatically.

Things to ask Shelley once the skills are in place:

• "Build me a web app that calls a phone number I give it and shows the transcript."
• "Add voice input to this app — transcribe uploads with Speko."
• "Call +1 415 555 0142 and tell me if they picked up." Shelley reads the number back and asks for a yes before dialing.

Both skills authenticate with a platform key: mint one at platform.speko.ai/agents/keys and export it as SPEKO_API_KEY in the VM.

Launch the voice-agent starter

One click creates a VM, clones voice-agent-starter, and opens Shelley. Following the repo's AGENTS.md, Shelley asks for your SPEKO_API_KEY, installs dependencies, and starts the app: a browser page where you talk to a Speko voice agent over WebRTC.

The same button works from the starter's README, and you can put it on your own Speko-powered repos: link https://exe.dev/new?repo=<your-repo-url>.

Use MCP from Claude Code or Codex

Every exe.dev VM ships with Claude Code and Codex preinstalled, and both speak MCP — Shelley itself does not, which is why the skills above are its native path. Connect the hosted server:

https://mcp.speko.ai/mcp

Setup, auth options, and prompts that work well: MCP.

Next steps