Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.automagik.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
Project Commands

The genie project command group manages named projects for organizing tasks across repos. Projects scope boards and tasks, and provide aggregate stats.
A project groups tasks and boards; a team groups agents working inside a worktree. They’re independent — you can run several teams against one project (different branches of the same wish), or one team across several projects (a sweep that touches multiple repos).

​
genie project list

List all projects. 
genie project list [--all] [--json]

​
genie project create

Create a new project. 
genie project create <name> [options]
OptionDescription
--virtualCreate a virtual project (not tied to a repo)
--repo <path>Repo path for the project
--description <text>Project description
genie project create "Auth Refactor" --repo ~/projects/api
genie project create "Cross-team Initiative" --virtual

​
genie project show

Show project detail with task stats — counts by stage, priority, and status. 
genie project show <name> [--json]

​
genie project set-default

Set the default project for when you’re outside any repo directory. 
genie project set-default <name>

​
genie project archive

Archive a project. Archived projects are hidden from project list unless --all is used. 
genie project archive <name>
Archiving a project hides its tasks from the default views but does not delete them. If you archive the project tied to the repo you’re currently in, new genie task calls will fall back to the default project until you unarchive or set-default.

​
genie project unarchive

Restore an archived project. 
genie project unarchive <name>

​
Project Scoping

Projects scope tasks and boards. When you run genie task list inside a repo, it automatically scopes to that repo’s project. Use --all to see tasks across all projects: 
# Tasks for current repo's project
genie task list

# Tasks across all projects
genie task list --all

# Tasks for a specific project
genie task list --project "Auth Refactor"
Use --virtual for initiatives that span multiple repos (cross-cutting refactors, documentation sweeps, compliance work). Virtual projects don’t require a repo path, so they scope tasks across whatever repos the work touches.

​
See also

Projects (concept)

How projects, repos, and default scoping fit together.

Boards

Boards scope inside a project — one project can host several boards.

Tasks

Create and move the tasks that live inside a project.

Team

Teams execute work; projects track the work itself.