Quick Start

Choose your path:

• No Code - Write natural language, deploy in minutes
• TypeScript - Full control with code

No-Code Quick Start

Describe your twist and Plot will do the rest.

1. Create plot-twist.md:

# My Calendar Twist

I want a twist that:

- Syncs my Google Calendar events into Plot
- Creates tasks for upcoming meetings
- Sends reminders 10 minutes before meetings

2. Deploy:

npx @plotday/twister login
npx @plotday/twister deploy

That's it! Learn more →

Developer Quick Start

Build twists with TypeScript for maximum flexibility.

1. Create a new twist:

npx @plotday/twister create

2. Implement your twist:

import {
  ActivityType,
  type Priority,
  type ToolBuilder,
  Twist,
} from "@plotday/twister";
import { Plot } from "@plotday/twister/tools/plot";

export default class MyTwist extends Twist<MyTwist> {
  build(build: ToolBuilder) {
    return {
      plot: build(Plot),
    };
  }

  async activate(priority: Pick<Priority, "id">) {
    await this.tools.plot.createActivity({
      type: ActivityType.Note,
      title: "Welcome! Your twist is now active.",
    });
  }
}

3. Deploy:

npm run plot login
npm run deploy

Complete guide →

Core Concepts

Twists

Twists are smart automations that connect, organize, and prioritize your work. They implement opinionated workflows and respond to lifecycle events.

// Lifecycle methods
async activate(priority)   // When twist is added to a priority
async deactivate()         // When twist is removed
async upgrade()            // When new version is deployed

Twist Tools

Twist tools provide capabilities to twists. They are usually unopinionated and do nothing on their own. Use built-in tools or create your own.

Built-in Tools:

• Plot - Manage activities and priorities
• Store - Persistent key-value storage
• AI - Language models with structured output
• Integrations - OAuth authentication
• Network - HTTP access and webhooks
• Tasks - Background task execution
• Callbacks - Persistent function references

View all tools →

Activities

The core data type representing tasks, events, and notes.

await this.tools.plot.createActivity({
  type: ActivityType.Action,
  title: "Review pull request",
  links: [
    {
      type: ActivityLinkType.external,
      title: "View PR",
      url: "https://github.com/org/repo/pull/123",
    },
  ],
});

Learn more →

CLI Commands

# Authentication
plot login

# Twist management
plot create                    # Create new twist project
plot generate                  # Generate code from plot-twist.md
plot deploy                    # Deploy to Plot
plot logs                      # Stream real-time twist logs

# Priority management
plot priority list             # List all priorities
plot priority create           # Create new priority

Complete CLI reference →

Documentation

📚 Full Documentation at twist.plot.day

Guides

• Getting Started - Complete walkthrough
• Core Concepts - Twists, tools, and architecture
• Built-in Tools - Plot, Store, AI, and more
• Building Custom Tools - Create reusable twist tools
• Runtime Environment - Execution constraints and optimization
• Advanced Topics - Complex patterns and techniques

Reference

• CLI Reference - Complete command documentation
• API Reference - TypeDoc-generated API docs

Examples

Simple Note Twist

export default class WelcomeTwist extends Twist<WelcomeTwist> {
  build(build: ToolBuilder) {
    return { plot: build(Plot) };
  }

  async activate(priority: Pick<Priority, "id">) {
    await this.tools.plot.createActivity({
      type: ActivityType.Note,
      title: "Welcome to Plot! 👋",
    });
  }
}

GitHub Integration

export default class GitHubTwist extends Twist<GitHubTwist> {
  build(build: ToolBuilder) {
    return {
      plot: build(Plot),
      network: build(Network, {
        urls: ["https://api.github.com/*"],
      }),
    };
  }

  async activate(priority: Pick<Priority, "id">) {
    // Set up webhook for issue updates
    const webhookUrl = await this.tools.network.createWebhook("onIssueUpdate");
    await this.set("webhook_url", webhookUrl);
  }

  async onIssueUpdate(request: WebhookRequest) {
    // Sync GitHub issues to Plot activities
  }
}

More examples →

TypeScript Configuration

Extend the Twist Creator's base configuration in your tsconfig.json:

{
  "extends": "@plotday/twister/tsconfig.base.json",
  "include": ["src/*.ts"]
}

Support

• Documentation: twist.plot.day
• Issues: github.com/plotday/plot/issues
• Website: plot.day

License

MIT © Plot Technologies Inc.