Skip to content
pdsa

Multi-project

Each project keeps its own graph database, so learning never bleeds between repos.

Managing projects

Section titled “Managing projects”
Terminal window
pdsa project set <name>   # persist the active project
pdsa project list         # projects + cycle counts (* = active)
pdsa project show         # active project / DB path
pdsa project clear        # unset (fall back to cwd name)

Graph DBs accumulate at:

{LocalAppData}/pdsa-cli/{project}/graph.kuzu

Resolution priority

Section titled “Resolution priority”
--project <name>  (one-off, per command)
  → active project (pdsa project set)
  → current directory name

Running projects concurrently

Section titled “Running projects concurrently”

pdsa project set writes a global active-project state, so if you run several projects in parallel they would overwrite each other. Instead, pass --project <name> on each command — that invocation runs independently against the named project’s DB:

Terminal window
pdsa plan "..." --project svc-a   &
pdsa plan "..." --project svc-b   &

The CLI is stateless per invocation (it runs and exits), and each project’s DB is separate, so concurrent runs against different projects don’t collide.