Project CLI

This version adds a single global control file:

workspace.md

Use it for shared context that applies across projects.

See conf/specs.md for the markdown syntax and internal parser behavior expected by the CLI.

Workspace shape

workspace/
  workspace.md
  projects/
    some-project/
      project.md
      app-or-workdir/

Implementation work for a project should live inside that project's own folder. If a task appears to require writing outside the project folder, the agent should ask for permission first.

New commands

Start AI work on a task:

python ja.py start sample-project T-001

Start AI work on the first ready task in a project:

python ja.py start sample-project

Start one agent per active project:

python ja.py start --active --full-auto

start generates a derived cross-project snapshot at .ja/context/project-context.md. Agents are instructed to read that file together with projects/workspace.md.

Projects can opt into lightweight recurring work by adding - recurrence: every_start to ## Meta. When start --active runs, the CLI creates a fresh ready task for that active project if it has no task currently ready or working.

Show the terminal dashboard:

python ja.py monitor
python ja.py monitor --once

Validate workspace and project file syntax:

python ja.py validate

Preview the generated prompt without launching Codex:

python ja.py start sample-project T-001 --print-prompt

Show the global control file:

python ja.py show-workspace

List active projects:

python ja.py list-active

Suggest what to do now:

python ja.py what-now

Replace the active project list:

python ja.py set-active sample-project website-refresh research-notes

set-active now updates each project's Meta.status field instead of writing activity state into workspace.md.

Existing commands

python ja.py add-project --title "Sample Project" --description "Short summary of the project goal"
python ja.py list-projects
python ja.py show sample-project
python ja.py list-ready
python ja.py list-waiting
python ja.py add-task sample-project "Draft initial outline" --owner owner --status ready
python ja.py set-task-status sample-project T-001 working
python ja.py add-update sample-project owner T-001 "Finished the first pass and noted follow-up questions."

add-project creates projects/projects/<slug>/project.md from the supplied title and description, adds a starter ready task, and then asks whether to launch an initial pass to flesh out the project details.