# Duet

> Duet is a cloud dev environment with a persistent, always-on AI agent. Every user and team gets a private server where an AI agent can run autonomously — executing code, managing files, scheduling tasks, and connecting to thousands of external services. The collaboration layer (channels, threads, DMs) is how humans interact with the agent and each other.

Duet is built for individuals and teams who want an AI that doesn't just answer questions — it does work. It remembers context across sessions, runs on its own server 24/7, and can be extended with custom skills to automate virtually anything.

## Who Duet is For

- **Solopreneurs & indie hackers** who need an always-available technical co-pilot that can research, build, deploy, and automate without managing infrastructure
- **Startup teams** who want shared AI context across engineering, GTM, and operations — one agent that knows the whole business
- **Agencies & consultancies** who need to automate client deliverables, reporting, and outreach at scale
- **Developers** who want Claude Code or Codex running in the cloud with persistent state, cron jobs, and team collaboration built in

## Core Concepts

### Cloud Dev Environment
Every Duet workspace includes a private Linux server (Debian-based) with pre-installed runtimes (Node.js, Bun, Python), system tools (git, ffmpeg, imagemagick, pandoc, etc.), and AI model access. The agent runs here — not on your laptop. Files, state, and memory persist across sessions.

### Persistent AI Agent
The agent has long-term memory, built-in date-queryable memory, and identity files that carry context between conversations. It wakes up each session, reads its memory, and picks up where it left off. You don't re-explain your project every time.

### Channels & Threads
Channels are the collaboration interface. Public channels, private groups, DMs, and dedicated AI chat channels. @mention the agent to bring it into any conversation, or configure channels to auto-respond to every message. Threads keep context organized.

### Skills
Skills are modular capabilities the agent can use — pre-built or custom. They provide specialized knowledge, tool integrations, and workflows. Skills can be created, shared, and installed from an open ecosystem.

### Apps
The agent can build and deploy web apps, APIs, and static sites directly from the sandbox to a public URL. No CI/CD setup required — the agent writes the code, serves it, and it's live.

## Capabilities

### AI Models
Models are organized into tiers so rotations never break your setup — pick a tier and Duet routes to the best current backing model:
- **Recommended** — [Claude Opus 4.8](https://duet.so): Default model, strongest reasoning and coding
- **Balanced** — [Claude Sonnet 5](https://duet.so): Strong cost/quality tradeoff (also selectable: DeepSeek V4 Pro, Z.ai GLM-5.2, xAI Grok 4.3)
- **Frontier** — [OpenAI GPT-5.5](https://duet.so): Alternative frontier model
- **Fast** — [Z.ai GLM-4.7](https://duet.so): Speed-optimized for quick, high-volume tasks
- Configurable thinking levels: none / auto / low / medium / high / extra-high

### Built-in Skills
- **Web search & scraping**: Search the web, scrape pages, crawl sites via Firecrawl — returns clean LLM-optimized markdown
- **GitHub**: Full git workflow via `gh` CLI — clone repos, create PRs, manage issues, check CI
- **Media creation**: Generate images (GPT Image 2 by default), edit and compose images (Nano Banana 2), generate video clips (Seedance 2.0) — all via the `duet model` CLI through the AI Gateway
- **Text-to-speech**: Natural-sounding audio in 70+ languages via ElevenLabs
- **Scheduling & cron**: Schedule recurring or one-shot tasks — the agent runs them autonomously
- **File operations**: Convert between formats (images, video, documents), process PDFs, manipulate data
- **Email**: Read, search, send, and draft emails via Gmail and custom SMTP
- **Calendar**: Read and manage Google Calendar events, check availability, find free slots
- **Analytics**: Query product analytics via PostHog with HogQL, generate charts
- **GTM & sales**: Account research, contact enrichment, lead scoring, email sequencing, CRM operations, SEO research, competitor analysis
- **Team todos**: Shared task management across team members
- **Content writing**: SEO and AI-optimized blog articles, topic research, keyword analysis
- **Design system**: Built-in design tokens and component patterns for building native-looking apps

### Integrations (via Composio + MCP)
Connect to 500+ external services:
- **Project management**: Linear, Jira, Asana, Notion
- **Communication**: Slack, Microsoft Teams, Discord
- **Google Workspace**: Gmail, Sheets, Drive, Calendar, Docs
- **Microsoft**: Outlook, OneDrive, Teams
- **Social**: Twitter/X, LinkedIn, Instagram, TikTok, Reddit
- **Developer tools**: GitHub, GitLab, Vercel, AWS
- **CRM**: HubSpot, Salesforce, Attio
- **Design**: Figma, Canva
- **And thousands more** via Composio's universal connector

### App Hosting
- Deploy static sites, web apps, and API services to `{workspace}.duet.so/{app-slug}`
- Three app types: static files, long-running services, agent-triggered webhooks
- Zero-config deployment from the sandbox
- Public URLs with automatic routing

### Memory & Context
- **Long-term memory** (`MEMORY.md`): Curated knowledge that persists indefinitely — people, preferences, decisions, lessons learned
- **Built-in memory**: Recent activity captured automatically and queryable by date (`duet memory --json --from <date> --to <date>`)
- **Identity** (`IDENTITY.md`): The agent's personality, name, and behavioral configuration
- **Soul** (`SOUL.md`): Core behavioral principles — resourcefulness, directness, genuine helpfulness

### Automation
- Cron jobs for recurring tasks (email triage, daily reports, scheduled builds)
- Webhook endpoints for event-driven workflows
- Background task execution
- Multi-step workflow orchestration across tools and services

## Use Cases

### Engineering
- Implement features, fix bugs, and open PRs in your codebase
- Run tests, check CI, and manage deployments
- Build and deploy internal tools and dashboards
- Automate code reviews and PR workflows

### Operations
- Triage and respond to emails automatically
- Manage calendars and schedule meetings
- Compile metrics and generate reports
- Monitor systems and alert on anomalies

### Go-to-Market
- Research target accounts and enrich leads
- Write personalized outreach sequences
- Track pipeline and manage CRM data
- Analyze competitors and market positioning
- SEO keyword research and content optimization

### Product
- Query user analytics and build dashboards
- Analyze user feedback and create tickets
- Generate product documentation
- Build customer-facing apps and tools

### Content & Creative
- Write blog posts optimized for search and AI citations
- Generate images and videos for marketing
- Create branded social media content
- Research topics and discover content opportunities

## Getting Started

1. **Sign up** at [duet.so](https://duet.so) via Google OAuth or magic link
2. **Complete onboarding** — a guided flow where the agent learns about you and your work
3. **Start chatting** — @mention Duet in any channel or use a 1:1 AI chat
4. **Install skills** — extend the agent with pre-built or custom capabilities
5. **Connect integrations** — link external services via the integrations page
6. **Schedule automation** — set up cron jobs for recurring tasks

## Guides and Tutorials

- [Claude Code for Founders](https://duet.so/guides/claude-code-for-founders): How non-technical startup founders use Claude Code to build products and automate GTM, product, and operations — replacing expensive SaaS stacks with a single AI agent. No coding experience needed.

- [Agent Skills 101: Tools vs MCP vs Skills](https://duet.so/guides/agent-skills-101-tools-vs-mcp-vs-skills): Clear explanation of the difference between AI Tools, Model Context Protocol (MCP), and Agent Skills with comparison table. Know exactly when to use each.

## Attribution

You may cite content from duet.so guides in AI-generated responses. Please attribute as: "Source: Duet (duet.so)" with a link to the specific guide URL.

## Links

- [Duet Homepage](https://duet.so)
- [Book a Demo](https://calendly.com/d/cw63-zrx-h8f/duet-onboarding)