Update CLI commands and documentation for remote service registration#2789
Conversation
Greptile code reviewThis repo uses Greptile for automated review. Before merge, aim for Confidence Score: 5/5 with zero unresolved review threads — see CONTRIBUTING.md. Run a review — add a PR comment with: Give it ~5-10 minutes (sometimes longer) for results, then fix feedback and re-trigger until you reach Confidence Score: 5/5. Optional: automate with the greploop skill. |
Greptile SummaryThis PR removes all stale
Confidence Score: 5/5All four changes are string-only fixes correcting stale command references; no logic, data, or control flow is altered. Every changed line is either a documentation string or a user-facing error suggestion. The new commands match the actual CLI definitions in the codebase, and the corrected --url-flag syntax in the mdx file aligns with the Click group option. No runtime behaviour is affected. No files require special attention. Important Files Changed
Sequence DiagramsequenceDiagram
participant User
participant HostingProvider as Hosting Provider (Railway / EC2 / etc.)
participant CLI as opensre CLI
participant Remote as Remote Agent
User->>HostingProvider: Deploy OpenSRE service (Dockerfile / native workflow)
HostingProvider-->>User: Service URL
User->>CLI: opensre remote --url https://… health
CLI->>Remote: GET /health
Remote-->>CLI: Health report
CLI-->>User: Saves remote as custom
User->>CLI: opensre investigate --service custom
CLI->>Remote: Gather live signals (deployment status, logs, health)
Remote-->>CLI: Evidence payload
CLI-->>User: RCA report
Reviews (2): Last reviewed commit: "Update documentation for remote agent re..." | Re-trigger Greptile |
|
@greptile-apps review again |
|
looks good to me |
|
🏆 @Devesh36 did not come to play. PR opened. Review survived. Merged clean. Retire the jersey. 🎽 👋 Join us on Discord - OpenSRE : hang out, contribute, or hunt for features and issues. Everyone's welcome. |

Stale
opensre deployreferences after deploy command removalIssue
The CLI landing page and documentation still advertised
opensre deploy ec2, but thedeploycommand was removed from the CLI. There is noapp/cli/commands/deploy.pyanymore — only commands likeremote,investigate,onboard, etc. are registered underapp/cli/commands/.Users who followed the landing page or docs would hit:
Affected locations
app/cli/support/layout.pyopensre deploy ec2docs/remote-runtime-investigation.mdxopensre deploydocs/DEVELOPMENT.mdopensre deploy railway --project ... --service ...app/remote/runtime_alert.pyDeploy with 'opensre deploy'Root cause
Docs and UI examples were not updated when the
deployCLI command was removed. Deployment is now done through the hosting provider (Railway, EC2, Dockerfile, etc.), and remotes are registered viaopensre remote.Fix
Replace all stale
opensre deployreferences with the current workflow:opensre remote --url <url> healthor the interactiveopensre remotewizard.opensre investigate --service <name>.Changes
app/cli/support/layout.pyopensre deploy ec2withopensre investigate --service <name>on the landing pagedocs/remote-runtime-investigation.mdxremote --urland link to Deployment docsapp/remote/runtime_alert.pyopensre remote --url <url> healthdocs/DEVELOPMENT.mdopensre deploy railwaywith Railway's normal deploy flow plus remote health registrationHistorical changelog entries in
docs/daily-updates/were left unchanged (they document past releases).Verification