Skip to content

Conversation

@drdoc-bot
Copy link

@drdoc-bot drdoc-bot bot commented Jan 14, 2026

Overview

Updated the README.md documentation to accurately reflect the current state of the codebase (v0.0.7).

Changes

Fixed Issues

  • Command syntax error: Changed sos session -i to sos session --image (the -i flag doesn't exist)
  • Typo: Removed extra space in sos sandbox --server example

Added Documentation

  • Version number: Added v0.0.7 to the header
  • Missing CLI flags:
    • --timeout SECONDS for sos serve (default: 600s)
    • --formatted / -f for sos sandbox trajectory
    • --remove / -r for sos sandbox stop

Complete HTTP API Reference

  • Added GET /sandboxes/{id}/trajectory/formatted endpoint
  • Documented all SandboxInfo response fields:
    • id, status, image, setup_commands, session_command_count, last_standalone_exit_code
    • created_at, started_at, stopped_at, container_id
  • Documented CommandResult fields including the exited boolean
  • Documented request parameters (timeout, remove, standalone, image, setup_commands)

Enhanced Usage Examples

  • Added "How It Works" section explaining:
    • Session vs standalone execution modes
    • Concurrency control (10 sandbox default)
    • Timeout behavior
    • Setup command chaining with &&
  • Added complete usage examples (Python development, Node.js workflows)
  • Clarified that multiple --setup flags are supported

Verification

All changes were verified against the actual source code:

  • src/cli/main.rs - CLI command definitions and flags
  • src/lib/http.rs - HTTP API endpoints and response structures
  • src/lib/sandbox/mod.rs - Sandbox implementation and public API

The documentation now accurately reflects the current CLI interface and HTTP API.

…tation

    - Add version number v0.0.7 to header
    - Fix sos session command syntax (--image instead of -i)
    - Add missing CLI flags:
      - --timeout SECONDS for sos serve
      - --formatted for sos sandbox trajectory
      - --remove for sos sandbox stop
    - Document complete HTTP API:
      - Add GET /sandboxes/{id}/trajectory/formatted endpoint
      - Document SandboxInfo response fields
      - Document CommandResult fields including exited
      - Document request parameters (timeout, remove)
    - Fix typo in sos sandbox --server example
    - Update setup command syntax to show multiple --setup flags
    - Document --timeout parameter for server (default 600s)
    - Add more complete usage examples including Python and Node.js workflows
@drdoc-bot drdoc-bot bot mentioned this pull request Jan 14, 2026
@deathbyknowledge
Copy link
Owner

@docbrown-dev can you also bump to 0.0.8

@drdoc-bot
Copy link
Author

drdoc-bot bot commented Jan 14, 2026

On it — I'll bump the version to 0.0.8.

@drdoc-bot
Copy link
Author

drdoc-bot bot commented Jan 14, 2026

Done! I've bumped the version to 0.0.8 in Cargo.toml and pushed the change.

Change made:

  • Updated Cargo.toml: 0.0.70.0.8

The change is now on the main branch. You can see it at:
main

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants