Skip to Content
New to Genbox? Check out our Getting Started guide
Commandsrun-prompt

gb run-prompt

Run a Claude Code prompt remotely in your Genbox environment.

Synopsis

gb run-prompt <prompt> [options] gb run <prompt> [options]

Description

Executes a Claude Code prompt directly in your Genbox environment. Perfect for running AI-assisted tasks in the cloud context.

Arguments

ArgumentDescription
promptThe prompt to execute

Options

OptionDescription
--name <env>Target environment
--app <name>Run in specific app directory
--streamStream output in real-time
-y, --yesAuto-approve all tool calls

Examples

Basic Usage

gb run "fix the TypeScript errors in the auth module"

Target Specific App

# Run in API directory gb run "add input validation to the users endpoint" --app api

Stream Output

# Watch Claude work in real-time gb run "refactor the database queries for better performance" --stream

Auto-Approve

# Don't prompt for tool approvals gb run "run the tests and fix any failures" -y

Use Cases

Bug Fixes

gb run "investigate and fix the login timeout issue"

Code Generation

gb run "create a new endpoint for user preferences with full CRUD operations"

Testing

gb run "write unit tests for the payment service"

Refactoring

gb run "refactor the auth middleware to use dependency injection"

Documentation

gb run "add JSDoc comments to all exported functions in the API"

Environment Context

Claude Code runs with full access to:

  • Your codebase in the Genbox
  • Running services (can test changes)
  • Database (can inspect data)
  • Environment variables
  • Terminal commands

Notes

  • Requires Claude Code to be installed in the Genbox
  • Uses your Claude API key (configured during login)
  • Prompts run in the Genbox, not locally
  • Changes are made directly in the Genbox

See Also

Last updated on