Context
Exxperts is currently primarily designed for interactive use. To enable integration with CI/CD pipelines, automated workflows, and background processes, Exxperts should support headless operation similar to OpenCode.
Proposed Solution
Add two execution modes to the Exxperts CLI:
- serve: Starts Exxperts as a long-running, headless server that can be accessed remotely.
- run: Executes a single command or prompt non-interactively and exits once the task is complete.
This would make it possible to build agent loops with Exxperts that run in pipelines or as background processes without requiring an interactive terminal.
Use Cases
- Run an Exxpert as a step in a GitHub Actions or GitLab CI pipeline.
- Host Exxperts on a server, VPS, or Kubernetes cluster.
- Run autonomous agent loops in the background.
- Execute a single task from a shell script or another application.
Acceptance Criteria
- The CLI provides a serve command for starting a headless Exxperts server.
- The CLI provides a run command for executing a single prompt or command.
- run exits after the task has completed.
- run returns an appropriate exit code for success and failure.
- Both modes work in environments without a TTY, such as Docker containers and CI runners.
- Server configuration, including host, port, and authentication, can be configured through environment variables or a configuration file.
Context
Exxperts is currently primarily designed for interactive use. To enable integration with CI/CD pipelines, automated workflows, and background processes, Exxperts should support headless operation similar to OpenCode.
Proposed Solution
Add two execution modes to the Exxperts CLI:
This would make it possible to build agent loops with Exxperts that run in pipelines or as background processes without requiring an interactive terminal.
Use Cases
Acceptance Criteria