Project Actions

Ditch the bash scripts. Define project commands in YAML —
for humans and AI agents alike

$ curl -fsSL https://project-actions.org/install.sh | bash

Run in your project root. Installs the runner + creates .project/

Paste into Claude Code, Copilot, Cursor, or any AI agent

Please fetch https://project-actions.org/for/agents, read the instructions, then install and configure Project Actions in this project.

Your agent reads the machine-optimized guide and sets everything up automatically.

See It In Action

Define once. Run anywhere.

Your team runs it. Your CI runs it. Your AI agent runs it.

.project/up.yaml

# Start the project
help:
  short: Start the project
  order: 10
context: outside-container
steps:
  - check-for: docker
    if-missing: "Install Docker first"
  - action: compose-up
  - if-option: fresh
    then:
      - command: migrate
  - echo: "✅ Project is up!"

Terminal

$ project

Available commands:
  up       Start the project
  down     Stop the project
  console  Open a shell
  migrate  Run migrations

$ project up --fresh

  → check-for: docker     ✓
  → compose-up            ✓
  → migrate               ✓

✅ Project is up!

Why Project Actions

Everything your project needs

🤖

Agent-Ready

Claude, Copilot, and Cursor can discover and run your project commands via the /for/agents page.

📦

Actions Library

Browse built-in actions and starter packs. Docker, migrations, env setup — add them with copy-paste YAML.

⚡

Zero Config

One curl command installs the runner. Write YAML, run project <name>. No build step.

🐳

Docker Native

Built-in Docker Compose actions. Run commands inside containers or on the host with a single context: field.

📋

Auto-Generated Help

Run project to list commands. project <name> --help for details. Docs live in YAML.

🔗

Composable

Commands call other commands. Conditionals, options, nesting. Complex workflows from simple readable steps.

Quick Start

Up and running in 2 minutes

Install in your project directory

$ curl -fsSL https://project-actions.org/install.sh | bash

Create your first command

.project/setup.yaml

help:
  short: Set up the project
steps:
  - run: npm install
  - echo: "Ready!"

Run it

$ project setup
→ npm install ... ✓
✅ Ready!

Full Quick Start Guide → Browse Actions Library