Skip to main content

​
Shell

cmd/crewship/cmd_shell.go opens an interactive REPL session. Each typed line is dispatched to the default agent via the ask pipeline; slash-commands inside the REPL control session state. @-prefixed tokens (e.g. summarise @notes.md) inline file content via the same ExpandAtFiles helper used elsewhere. The active agent latches across turns — /agent viktor, then plain “what’s up” still targets viktor.

​
crewship shell

No flags. The REPL is built on cli.NewREPL() and reads until EOF (Ctrl-D) or /quit.
The prompt string carries the active agent slug in square brackets so at a glance you know which agent will get the next message.

​
Slash commands (v1)

​
Examples (typed at the prompt)

​
Sticky state

Once set, /agent, /effort, /think, and /plan persist across turns. Plan-mode in particular wraps every subsequent prompt with the plan-mode prefix until /plan toggles it off — handy for an architect-only working session.

​
Common errors

  • no active agent. Set one with /agent <slug> — no default-agent configured and no /agent issued.
  • usage: /workspace <slug> — /workspace (or /cd) called with no argument.

​
See also

  • crewship ask — the one-shot equivalent; shell is essentially a REPL wrapper around it.
  • crewship slash — top-level slash commands (different surface: user-defined .md files).
  • crewship tui — full-screen Bubble Tea dashboard for monitoring rather than chat.