puter/paseo
1
0
Fork 0
mirror of https://github.com/getpaseo/paseo.git synced 2026-10-14 13:22:37 +00:00
Code Issues Packages Projects Releases Wiki Activity

Manage projects from the CLI (#3460)

Browse Source 
* feat(cli): manage projects

Expose the existing project lifecycle through one CLI command group so projects can be managed without opening the app.

* fix(cli): preserve remote project paths

Project paths belong to the daemon when a target is explicit. Require that path instead of resolving the CLI machine's cwd, and keep local convenience resolution for the default connection.

* docs(cli): document project management

* docs(cli): remove repeated project reference
This commit is contained in:
Mohamed Boudra
2026-08-16 20:32:08 +02:00
committed by GitHub
parent ac7796035d
commit ac4331456c
16 changed files with 417 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/paseo/SKILL.md
+15 -1
View File
@@ -1,10 +1,24 @@
---
name: paseo
description: Paseo reference for managing workspaces, workspace scripts, agents, schedules, and heartbeats.
description: Paseo reference for managing projects, workspaces, workspace scripts, agents, schedules, and heartbeats.
---
Paseo is a remote daemon that manages coding agents, terminals. Control it through MCP tools or the CLI.
## Projects
Manage the daemon's project registry through the CLI:
```bash
paseo project create [path]
paseo project ls
paseo project rename <project-id> <name>
paseo project rename <project-id> --reset
paseo project delete <project-id>
```
For a local daemon, `project create` defaults to the current directory and resolves relative paths on the CLI machine. With `--host` or `PASEO_HOST`, always provide a path; the target daemon interprets it on its own machine. Deleting a project archives its active workspaces and removes the project from Paseo without deleting the project directory.
## Workspaces
**`create_workspace`** — create a workspace independently of any agent. Required: `isolation` (`local` or `worktree`). Worktree isolation supports `mode: "branch-off" | "checkout-branch" | "checkout-pr"`: use `branchName`/`baseBranch` for a new branch, `branch` for an existing branch, or `prNumber` plus optional `forge`/`projectPath` for a change request. `worktreeSlug` controls the managed path. Returns the workspace descriptor centered on `workspaceId`.