occtl

What problem does it solve?

OpenCode session management across multiple projects is tedious and error-prone. occtl provides a unified CLI to manage sessions, read messages, watch events, send prompts, respond to permissions, and coordinate worktrees, reducing context switching and manual steps.

Core Features & Use Cases

• List sessions across directories with filters and sorting to monitor activity
• Read full message histories and fetch the last message for quick context
• Stream real-time session events (messages, status, diffs, todos) for live monitoring
• Send prompts programmatically with optional model/agent/variant configuration
• Respond to permission requests with manual or auto-approve options
• Inspect diffs, todos, and summaries to track progress and cost
• Manage git worktrees to enable parallel, isolated sessions and Ralph Mode workflows
• Install or view the bundled OpenCode skill for quick setup and usage
• Use cross-project orchestration patterns to coordinate work across directories
• Manage session lifecycles end-to-end from creation to sharing

Quick Start

Install occtl and use it to manage OpenCode sessions from the CLI by listing sessions, reading messages, sending prompts, and coordinating worktrees.