~/docs/quickstart

Quickstart

Get your first service deployed in under two minutes.


1. Create a Workspace

Sign in and create a workspace. This is your isolated environment where all services, workflows, and data live. Every workspace has its own brain, its own secrets, and its own set of services.

2. Ask the AI

Open the chat and ask for something. The AI will plan the architecture, build the service, and deploy it. Try something simple:

text
"Build me a status page that returns the current server time."

3. Watch It Build

The Orchestrator AI spawns the Architecture agent, which returns a build plan. After your approval, it commissions OpenCode to write the Deno service, registers endpoints, and deploys it. You get a public URL.

4. Use Your Service

Every action service gets a public URL. You can visit it in the browser, curl it from the terminal, or wire it into a workflow. The service is live and ready.

5. Set Up Secrets

If your service needs API keys or credentials, the AI creates secret placeholders. Go to your workspace secrets and fill in the values. The service auto-deploys once secrets are set.


Example: Your First Service

The AI writes services as Deno HTTP servers. Here's what a simple action service looks like:

typescript
import { serve } from "https://deno.land/std@0.224.0/http/server.ts";

serve(async (req: Request) => {
  const payload = await req.json();
  // your business logic here
  return new Response(JSON.stringify({ ok: true }), {
    headers: { "content-type": "application/json" },
  });
}, { port: 8080 });

Understand the architecture deeper.Services