Projects

Projects group related sessions and plans into a single entity with its own shareable page at rockstar.ninja/proj/{nanoid}.

Alias: rn proj

Automatic creation

Projects are created automatically when you push a session. The project label is derived from your local project directory name — pushing from ~/Projects/my-app/ creates a project named my-app. Subsequent pushes from the same directory are associated with the same project.

rn project list

List your projects with session/plan counts and URLs.

rn project list

rn project create

Create a new project manually.

rn project create <label>

Flags

Example

rn project create my-app --public --description "My cool project"

rn project rename

Rename a project. You can reference it by nanoid or label.

rn project rename <nanoid-or-label> <new-label>

rn project delete

Delete a project. Sessions and plans within the project are not deleted — they become standalone items.

rn project delete <nanoid-or-label>

rn project add-plan

Associate a plan with a project. Both arguments can be nanoids or labels/names.

rn project add-plan <project> <plan>

Plans added to a project appear as pinned reference cards on the project page.

rn project remove-plan

Remove a plan from a project. The plan itself is not deleted — it just loses its project association.

rn project remove-plan <project> <plan>

rn project set-privacy

Set a project's privacy level. Valid levels are public, secret, and private.

rn project set-privacy <nanoid-or-label> <level>

Project privacy acts as a ceiling — a private project hides all its contents from non-owners, regardless of individual item privacy. See Privacy & Visibility for details.

rn project open

Open a project page in your default browser.

rn project open <nanoid-or-label>

Identifier resolution

When you provide an identifier, the CLI resolves it via the server:

1. Exact nanoid match
2. Exact label match

If multiple projects share the same label, you'll see the matches and be asked to use the nanoid instead.