konstantin-paulus 963f3c1f6f Enhance project management commands and documentation
- Added the `dapi open` command to launch the app and open or create a project folder, with updates to the `README.md` and `projects.ts` for clarity.
- Implemented `initProject` function to initialize project folders, ensuring they can be opened from any location on disk.
- Updated the `main-channels.ts` and `main.ts` to handle new project initialization requests.
- Enhanced the database schema to support project root types, allowing for better project organization and retrieval.
- Improved the IPC layer to manage multiple routers for different command contexts, ensuring efficient command handling.
2026-08-24 10:26:09 +02:00

1.7 KiB

dapi open [path]

Launches Diffusion Studio — or surfaces the running instance — and, given a path, opens that folder as a project. The first command of the core loop: open, then mount, then render.

The folder may live anywhere on disk, and does not have to be a project yet. Opening is what makes it one, writing as little as that takes:

  • a missing folder is created;
  • a folder with no entry file (package.json main, or index.tsx and friends) gains an index.tsx holding an empty stage.

Nothing else is written — no package.json, tsconfig, README, or manifest. A project is its JSX; the rest of the scaffold appears lazily, each piece when something first needs it. A folder that is already a project is opened untouched, wherever it lives.

The app remembers the folder, so the project reopens across app relaunches and stays addressable by folder name or project id.

Input

  • [path]: project folder to open or create (optional; with no path the command just makes sure the app is up). Relative paths resolve against the shell's working directory.
  • -b, --background: launch or keep the app in the background, without raising a window. The way to drive the editor headless.

Output

With a path, the opened project as one JSON object:

{
  id:   string;   // package.json `projectId`; "" until the project has a record
  name: string;   // display name (falls back to the folder name)
  dir:  string;   // absolute project folder, as opened
}

With no path, nothing: exit code 0 says the app is up.

Errors

  • The path exists but is not a folder.
  • Off macOS, the app cannot be launched; the command then requires it to already be running.