feat: exec commands on container

[raghavyuva]

Closes #85

Summary by CodeRabbit

• New Features

  • Added a Terminal tab in container details for an in-browser shell session. Available when the container is running; otherwise shows guidance to start the container.

• Bug Fixes

  • Improved stability when displaying exposed ports to avoid rare rendering glitches with duplicate entries.

• Chores

  • Updated API version metadata release date.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Walkthrough

Adds a container terminal feature to the UI by introducing a Terminal component and a new “Terminal” tab on the container details page. Updates port badge keys in the overview to avoid collisions. Adjusts API version metadata by updating a release_date timestamp.

Changes

Cohort / File(s)	Summary
API version metadata api/api/versions.json	Updated release_date for version v1; no structural or other field changes.
Container terminal feature view/app/containers/[id]/components/Terminal.tsx, view/app/containers/[id]/page.tsx	Added a client-side Terminal component using xterm + WebSocket; integrated as a new “Terminal” tab (enabled when container is running) and sends an init docker exec command to attach a shell.
Ports list key fix view/app/containers/[id]/components/OverviewTab.tsx	Changed list rendering to use (port, index) and updated key to include index to prevent key collisions; display unchanged.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor U as User
  participant P as ContainerDetailsPage
  participant Tabs as Tabs
  participant Term as Terminal component
  participant HookR as useContainerReady
  participant HookX as useTerminal (xterm)
  participant WS as useWebSocket
  participant BE as Backend
  participant DK as Docker Engine

  U->>P: Navigate to container details
  P->>Tabs: Render tabs (overview/images/logs/details/terminal)
  U->>Tabs: Select "Terminal" tab
  Tabs->>Term: Mount with containerId
  Term->>HookR: Check container DOM ready
  HookR-->>Term: Ready
  Term->>HookX: initializeTerminal()
  HookX-->>Term: terminalInstance
  Term->>WS: sendJsonMessage({ action: 'terminal', data: { value: initCmd, terminalId } })
  WS->>BE: Forward terminal init and subsequent I/O
  BE->>DK: docker exec -it {containerId} /bin/bash || /bin/sh
  DK-->>BE: PTY stream
  BE-->>WS: Data frames
  WS-->>Term: Data
  Term-->>U: Interactive shell I/O

  note over Term,WS: Init command sent once (guard + slight delay)

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• chores: fixing CSS inconsistencies across pages | modifying CSS view #312 — Also updates api/api/versions.json release_date for v1.
• feat: add table component for containers listing and component seggregation #356 — Related to port badge keys; both touch port-based list keying in container UI.

Poem

A tap on the tab and the shell springs to life,
I thump-thump commands, no SSH strife.
Ports line up neatly, keys won’t collide,
A warren of containers, I burrow inside.
With whiskered wit and terminal cheer—
Exec away, the rabbit is here! 🐇💻

✨ Finishing touches

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/exec_commands_on_container

---

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.}

[raghavyuva]

@coderabbitai summary

[coderabbitai]

✅ Actions performed

Summary regeneration triggered.

[zhravan]

Nice, LGTM