Skip to content

ORCHESTRATION.md

Latest commit

 

History

History
75 lines (48 loc) · 2.53 KB

ORCHESTRATION.md

File metadata and controls

75 lines (48 loc) · 2.53 KB

Orchestration Workflow

Paude supports a fire-and-forget workflow: assign the agent a task, monitor progress, harvest the changes into a branch, and open a PR — all without connecting to the session.

Assign a Task

Create a session with --git to push your code, then give the agent a task with -a:

cd your-project
paude create --yolo --git my-project -a '-p "refactor the auth module"'

The agent works autonomously inside the container. You can disconnect and come back later.

Monitor Progress

Check what the agent is doing with paude status:

paude status
SESSION              PROJECT         BACKEND    ACTIVITY   STATE      SUMMARY
my-project           your-project    podman     2m ago     Active     Refactoring auth module

The STATE column shows Active when the agent is working or Idle when waiting.

Harvest Changes

When the agent finishes (or you want to review progress), pull the changes into a local branch:

paude harvest my-project -b feature/auth-refactor

This creates a local feature/auth-refactor branch with all of the agent's commits. Review the diff, run tests, and iterate as needed.

Protected branches (main, master, release, release-*, release/*) cannot be used as harvest targets.

Open a PR

Once you're satisfied with the changes, harvest again with --pr to push the branch and create a pull request:

paude harvest my-project -b feature/auth-refactor --pr

# Or with a custom PR title
paude harvest my-project -b feature/auth-refactor --pr --pr-title "Refactor auth module"

This pushes feature/auth-refactor to origin and runs gh pr create.

Reset and Repeat

After the PR merges, reset the remote session to prepare for the next task:

paude reset my-project

Reset fetches from origin, checks out the target branch, runs git reset --hard to origin/main (or a custom branch via --branch/-b), and runs git clean -fdx inside the container. It also clears conversation history (session state, todos, and project subdirectories, while preserving per-project settings). Use --keep-conversation to preserve history across tasks. The session must be running before you can reset it.

If the agent has unmerged work, reset warns you. Use --force to proceed anyway.

Then assign the next task — connect and type your prompt, or stop and recreate with -a:

paude connect my-project
# Or, for a fully autonomous run:
paude stop my-project
paude create --yolo --git my-project -a '-p "add rate limiting to the API"'