Skip to main content

​
Usage

codaph projects <command> [options]
Manage the Codaph project registry. The registry tracks multiple projects and remembers the last-used project for quick switching in the TUI.

​
Subcommands

​
list

List all registered Codaph projects: 
codaph projects list
Displays all projects in the registry with an asterisk (*) marking the last-used project. Example output: 
* /Users/dev/project-a
  /Users/dev/project-b
  /Users/dev/shared/project-c

​
add

Add a project to the registry: 
codaph projects add [--cwd <path>]
​
--cwd
string
Path to the project directory. Defaults to current directory.
Example: 
cd /Users/dev/my-project
codaph projects add

# Or specify path explicitly
codaph projects add --cwd /Users/dev/other-project

​
remove

Remove a project from the registry: 
codaph projects remove [--cwd <path>]
​
--cwd
string
Path to the project directory to remove. Defaults to current directory.
Example: 
codaph projects remove --cwd /Users/dev/old-project
Removing a project from the registry does not delete the project files or .codaph/ directory - it only removes the registry entry.

​
Registry Storage

The project registry is stored in: 
~/.codaph/registry.json
Format: 
{
  "schema": "codaph.registry.v1",
  "projects": [
    "/Users/dev/project-a",
    "/Users/dev/project-b"
  ],
  "lastProjectPath": "/Users/dev/project-a"
}

​
Use Cases

Press p in the TUI to cycle through registered projects, or P to open the project manager overlay.The registry remembers your last project so the TUI opens to the right context.
Register all your Codaph-enabled projects once:
codaph projects add --cwd ~/work/api
codaph projects add --cwd ~/work/frontend
codaph projects add --cwd ~/work/mobile
Then switch between them in the TUI without typing paths.
Remove projects you no longer work on:
codaph projects list
codaph projects remove --cwd ~/old/archived-project

​
TUI Integration

The project registry powers TUI navigation:
  • p key: Cycle to next registered project
  • P key: Open project manager overlay (select, add, remove projects)
  • Auto-restore: TUI opens to last-used project on startup
Projects are automatically added to the registry when you run codaph init or open the TUI for the first time in a directory.
  • codaph init - Initialize a new Codaph project (auto-adds to registry)
  • codaph tui - Launch TUI with project switching
  • codaph status - View status of current or specified project

Build docs developers (and LLMs) love

Get started for freeTalk to us