Skip to content

ux: rename "Open a login shell" to "Open container shell" across agent roles #220

Description

@eXPerience83

Context

Remote Dev currently labels the general interactive shell action as:

Open a login shell

The implementation intentionally launches bash --login, so login shell is technically correct Bash terminology. However, in the menu it reads as if the shell were mainly for authentication/login tasks, while in practice it is the general-purpose interactive shell for the role container: diagnostics, inspection, recovery, manual commands and maintenance.

This became especially visible while using the Antigravity role for runtime/permission testing. The existing user guide already describes this action as a general shell rather than an agent launch.

Goal

Rename the user-facing action to:

Open container shell

without changing its runtime behavior.

Internally it should continue to launch the reviewed login-style Bash environment (bash --login) unless a separate issue changes that contract.

Scope

Apply the wording consistently to all current role menus and shared documentation:

  • Codex;
  • Antigravity;
  • shell/fallback role where applicable;
  • common/shared menu text, diagnostics/recovery guidance and tests;
  • EN/ES documentation and user guide references.

Also establish Open container shell as the naming convention for future agent roles, including the planned/future Claude Code role, so new integrations do not reintroduce the old label.

Required behavior

This is a UX/text-only change:

  • keep the command implementation as bash --login;
  • do not change shell privileges, mounts, cwd, environment, hardening, tmux lifecycle or role isolation;
  • preserve the existing post-shell secure-persistent-state hardening flow;
  • preserve P0 data loss: enforce project-collection Git boundary for Codex and Antigravity #213 behavior where the shell remains available for manual inspection/recovery when managed project actions are blocked;
  • do not turn this into an agent-specific login/authentication workflow.

Wording

Preferred English label:

Open container shell

Preferred Spanish wording in prose/docs where translated:

Abrir shell del contenedor

Keep literal menu strings synchronized wherever the UI intentionally remains English.

Tests

Update deterministic menu/tests that currently assert Open a login shell and add/retain coverage proving that selecting the renamed action still executes the same login-style Bash shell path and returns through the existing hardening/menu lifecycle.

Acceptance criteria

  • Current Codex and Antigravity menus show Open container shell.
  • Shared/fallback shell menu uses the same terminology where applicable.
  • Future Claude Code integration guidance uses the same naming convention.
  • EN/ES docs no longer describe the menu action with the misleading old label except where explaining historical terminology is useful.
  • Runtime behavior remains bash --login; no security or lifecycle semantics change.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions