Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

code run/status/attach/stop: 'initialize MCP session: transport closed' when agent-box is missing on the box

Open
#2,012 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
72/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
go
Domain
cli

Research direction

Start with internal/coderun/session.go and trace how the SSH subprocess and MCP session report failures when agent-box is absent. Use scripts/code-run-fake-agent-e2e.sh to reproduce the fresh-box case. Done means the CLI surfaces a clear missing-agent-box cause and remediation instead of only reporting a transport-closed error.

Written by the indexing model from the issue text.

Description

bug

Summary

On a plain freshly-created box (no agent-box installed), every containarium code run|status|attach|stop fails with:

Error: connect to agent-box on "<box>": initialize MCP session: transport error: transport closed

That says nothing about the actual problem: the CLI runs ssh <box> -- agent-box (internal/coderun/session.go), the remote shell answers command not found, ssh exits, and the MCP handshake sees EOF.

Repro

  1. containarium create <name> --ssh-key <pub> (no coding-agent provisioning).
  2. Wait for SSH to work.
  3. containarium code status <name>.

Expected

A clear error naming the cause and the fix, e.g. agent-box is not installed on <box> — install it (see docs) or provision the box for coding agents. Capture the ssh subprocess's stderr and surface it (or a check like command -v agent-box) rather than reporting only the transport EOF. Consider a containarium code install-style step (or extending it) that installs agent-box too, since code run cannot work without it.

Found by

scripts/code-run-fake-agent-e2e.sh on a fresh box; it now installs agent-box itself when missing.

Dominant language
Go
Stars
296
Forks
38
Avg merge
8h 22m
Merged PRs (30d)
353

Getting set up

This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from FootprintAI/Containarium

All issues in FootprintAI/Containarium

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.