Sessions

Sessions are the PTY processes that run inside each agent. Every agent has at least one session (the agent session), and can have additional sessions like a dev server.

The agent session

The agent session is required and always runs at PTY index 0. Its initialization script is the entry point for your agent.

# .botster/shared/sessions/agent/initialization
#!/bin/bash
claude --dangerously-skip-permissions

Additional sessions

Add more sessions by creating directories under sessions/:

# .botster/profiles/web/sessions/server/initialization
#!/bin/bash
bin/dev

Port forwarding

To enable port forwarding for a session, create a port_forward sentinel file next to the initialization script. This makes the session's port accessible via the preview UI and sets the $PORT environment variable.

sessions/server/
  initialization     # Startup script
  port_forward       # Empty file - enables port forwarding