Add vp attach and extend vp stop to accept container names

[nezhar]

Adds a new vp attach command for reattaching your terminal to a running VibePod-managed container, and extends the vp stop command to allow stopping a specific container by name or ID, in addition to stopping by agent name. The documentation is updated to explain these new workflows, and comprehensive tests are added for both commands. The Docker management code is also improved to support these new operations.

New CLI features and workflows:

• Added the vp attach command, allowing users to reattach their terminal to a running VibePod-managed container. This command can auto-select the container if only one is running, or take a container name/ID as an argument.
• Enhanced the vp stop command to accept either an agent name/shortcut (stopping all its containers) or a specific container name/ID (stopping just that container).

[augmentcode]

🤖 Augment PR Summary

Summary: This PR adds a new workflow for reattaching to running VibePod agent containers and extends stopping behavior to support container-level targeting.

Changes:

• Introduces a new vp attach command that attaches your terminal to an already-running, VibePod-managed agent container (auto-selecting when there is exactly one candidate).
• Extends vp stop to accept either an agent name/shortcut (stopping all containers for that agent) or a specific container name/ID (stopping only that container), plus --all support.
• Adds DockerManager helpers (get_container, stop_container) and improves error-wrapping for stop_agent, stop_all, and list_managed for more consistent CLI failures.
• Updates documentation to describe the new attach/stop workflows and clarifies that closing a terminal does not stop the container.
• Adds comprehensive pytest coverage for the new attach and updated stop command behaviors.

Technical Notes: The stop path now resolves arguments as agent name/shortcut first, then falls back to container name/ID lookup; attach is limited to running containers with an agent label.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. 3 suggestions posted.

Comment augment review to trigger a new review at any time.

[nezhar]

augment review

[augmentcode]

Review completed. 2 suggestions posted.

Comment augment review to trigger a new review at any time.

[coderabbitai]

Warning

Rate limit exceeded

@nezhar has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 26 minutes and 39 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 26 minutes and 39 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 36301046-a36f-4f56-b4fe-f55240574205

📥 Commits

Reviewing files that changed from the base of the PR and between 9e907a1 and ac709ce.

📒 Files selected for processing (8)

• docs/agents/index.md
• docs/quickstart.md
• src/vibepod/cli.py
• src/vibepod/commands/attach.py
• src/vibepod/commands/stop.py
• src/vibepod/core/docker.py
• tests/test_attach.py
• tests/test_stop.py

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch issue-56-1

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[nezhar]

augment review

[augmentcode]

Review completed. 2 suggestions posted.

Comment augment review to trigger a new review at any time.