Skip to main content

​
clawker exec

Execute a command in a running container

​
Synopsis

Execute a command in a running clawker container. This creates a new process inside the container and connects to it. Use -it flags for an interactive shell session. When —agent is provided, the container name is resolved as clawker.<project>.<agent> using the project from your .clawker.yaml configuration. Container name can be:
  • Full name: clawker.myproject.myagent
  • Container ID: abc123…
clawker exec [OPTIONS] CONTAINER COMMAND [ARG...] [flags]

​
Examples

  # Run a command
  clawker container exec clawker.myapp.dev ls -la

  # Run a command using agent name (resolves via project config)
  clawker container exec --agent dev ls -la

  # Run an interactive shell
  clawker container exec -it clawker.myapp.dev /bin/bash

  # Run an interactive shell using agent name
  clawker container exec -it --agent dev /bin/bash

  # Run with environment variable
  clawker container exec -e FOO=bar clawker.myapp.dev env

  # Run as a specific user
  clawker container exec -u root clawker.myapp.dev whoami

  # Run in a specific directory
  clawker container exec -w /tmp clawker.myapp.dev pwd

​
Options

      --agent             Use agent name as first argument (resolves to clawker.<project>.<agent>)
      --detach            Detached mode: run command in the background
  -e, --env stringArray   Set environment variables
  -h, --help              help for exec
  -i, --interactive       Keep STDIN open even if not attached
      --privileged        Give extended privileges to the command
  -t, --tty               Allocate a pseudo-TTY
  -u, --user string       Username or UID (format: <name|uid>[:<group|gid>])
  -w, --workdir string    Working directory inside the container

​
Options inherited from parent commands

  -D, --debug   Enable debug logging

​
See also

  • clawker - Manage Claude Code in secure Docker containers with clawker