Skip to main content

Create a project

Use actio create to scaffold a new project with the full Actio sidecar.

Command​

actio create <project_name>
  • project_name — Name of the new directory (e.g. my-service, api-gateway).
  • The project is created in the current working directory.

Example​

actio create demo-api

Output:

Created Actio-enabled project at /path/to/cwd/demo-api

Generated structure​

<project_name>/
├── ENTRYPOINT.yaml       # Entry file for AI agents
├── src/                # Your application code (empty)
└── actio/
    ├── router.yaml     # Context router
    ├── architecture/
    │   └── system.md   # System architecture doc
    ├── interfaces/
    │   └── contracts.yaml
    ├── patterns/
    │   └── pattern.md
    ├── rules/
    │   └── rules.md
    └── tasks/
        └── task.md

If the directory already exists​

actio create existing-dir
# Error: directory /path/to/existing-dir already exists

Choose another name or use actio init to add Actio inside an existing repo.

Next​