The Field Manual For Shipping By Message

CozyOps turns conversational messages into deployed, production-grade applications. Describe what you need. Get working code, a live preview URL, and an iteration loop that doesn't quit.

01 — Quickstart

From Zero to Live in Four Steps

No installs, no config files, no ceremony. Open a channel and start describing what you want.

1

Open a Channel

Start a conversation in any supported channel — web chat, Slack, Discord, or CLI.

$ cozy init my-project
2

Describe Your App

Write what you need in plain language. Be specific about features, layout, data, and behavior.

"I need a task board with drag-and-drop columns,
user assignment, and a deadline heatmap."
3

Review the Preview

CozyOps generates code and deploys it to a preview URL. Click, test, and verify in your browser.

Preview: taskboard.cozy.app/preview
4

Iterate and Ship

Send follow-up messages to adjust, fix, or add features. Each message triggers a new deploy cycle.

"Add a dark mode toggle and export to CSV."
Deploying update 3... done.
Note

Each iteration preserves your previous state. Rollbacks are available for the last 20 deploys. Send cozy rollback to revert.

02 — Architecture

How CozyOps Processes a Message

Every message moves through six stages — from natural language to a live URL. Here's the pipeline in detail.

Message Input

Your message enters CozyOps through any connected channel. The router identifies project context, detects language/framework intent, and queues the message for processing.

Intent Analysis

The planner parses your request into a structured task graph: components, routes, data models, API endpoints, and styling directives. Ambiguities are clarified in-channel.

Code Generation

The builder generates production code across your chosen stack. Output is linted, type-checked, and tested against your existing codebase. Conflicts are auto-resolved or flagged.

Cloud Deploy

Built artifacts are pushed to CozyOps' edge infrastructure. Static assets go to CDN, server functions deploy to regions closest to your users. SSL provisioned automatically.

Preview & Verification

A unique preview URL is returned to your channel. Open it in any browser. CozyOps runs automated smoke tests and reports visual regressions if a previous version exists.

Auto-Fix Loop

If smoke tests fail or you report an issue, CozyOps enters a repair cycle. It reads error logs, adjusts code, and redeploys — typically in under 30 seconds. The loop continues until the build passes or you intervene.

03 — Channels

Input Channel Matrix

CozyOps meets you where you already work. Send messages from any supported channel — same engine, same capabilities.

Channel Status Auth Features
Web Chat Live Email / SSO Full feature set, file uploads, live preview pane
CLI Live API Key Scripting, piped input, CI/CD integration, JSON output
Slack Live OAuth Thread-based iteration, slash commands, team sharing
Discord Beta Bot Token Server channels, DM mode, reaction-based approval
VS Code Beta Extension Auth Inline code actions, diff view, integrated terminal
GitHub Issues Soon GitHub App Issue-to-deploy, PR generation, label-based triggers
Tip

All channels share the same project state. Start in Slack, continue on the CLI, review in the web dashboard — context follows you.

04 — Deployment Model

Where Your Code Runs

CozyOps handles infrastructure so you focus on the product. Three deployment targets, zero config required.

Edge Static

Static sites and SPAs deploy to 280+ edge nodes worldwide. Sub-50ms TTFB. Assets fingerprinted, gzipped, and cached at the edge.

HTML/CSS/JS React/Vue/Svelte Global CDN

Serverless Functions

API routes and server logic run as isolated functions. Auto-scaled, zero cold-start on popular runtimes. Supports Node, Python, and Go.

API Routes Auth Handlers Cron Jobs

Managed Database

Persistent data in SQLite or Postgres — provisioned on demand. Schema managed from your messages. Backups every 6 hours, point-in-time recovery.

SQLite Postgres Auto-backup
05 — Reference

Command & Message Patterns

Use these patterns in any channel. Natural language works too, but these shorthand forms are faster when you know what you need.

cozy init <name> Create a new project workspace and set it as the active context for subsequent messages.
cozy status Show current project state: last deploy timestamp, preview URL, active branch, and pending tasks.
cozy deploy --prod Promote the current preview to production. Runs final validation checks before switching traffic.
cozy rollback [n] Roll back to a previous deploy. Defaults to the last version. Specify a number to go further back.
cozy logs --tail Stream live function logs from the deployed environment. Filter with --fn=<name>.
cozy env set KEY=value Set environment variables. Changes take effect on the next deploy cycle. Secrets are encrypted at rest.
"Fix the mobile layout" Natural language messages trigger the analysis → generate → deploy pipeline. No command prefix needed.
06 — Troubleshooting

Common Issues & Fixes

When things don't go as planned, start here. Most issues resolve in one message.

Preview shows a blank page

Usually caused by a runtime error in the entry component. Send cozy logs --tail to check for errors. Common fix: send "Fix the blank page error" and CozyOps will auto-diagnose from the logs.

Deploy stuck in "building" state

Builds timeout after 120 seconds. If it's stuck, send cozy status to check the queue. Heavy dependencies or large image assets can cause slowdowns. Try: "Optimize build and redeploy."

Styles or layout don't match what I described

Be more specific in your follow-up: reference exact sections, colors, spacing, or screen sizes. Example: "Make the header sticky, reduce the hero padding to 2rem on mobile, and change the primary button to green."

Environment variables not loading

Variables set with cozy env set require a redeploy to take effect. Run cozy deploy after setting. For client-side vars, prefix with PUBLIC_ — server-only vars are never exposed to the browser.

Database queries returning empty results

Check that your schema was applied: send cozy status and look for the "db" section. If the schema is pending, send "Apply the database schema and seed with sample data." Migrations run automatically on deploy.

I want to eject and self-host the code

Send cozy eject to export the full codebase as a zip or push it to a connected Git repo. The exported project includes a standard build configuration — no CozyOps lock-in. You can always reconnect later.