🔧 update (cli): add --docker flag for container environments

[youhanasheriff]

Summary

• Add --docker flag that routes to web-based setup (same as --web)
• Auto-detect Docker/container environments via CI, CONTAINER, DOCKER_CONTAINER env vars, /.dockerenv file, and /proc/1/cgroup container indicators
• Show container detection warning in interactive setup to guide users
• Extract shared isRunningInContainer() into detect-container.ts
• Updated help text with --docker documentation

Testing

• isRunningInContainer() returns false on local macOS
• isRunningInContainer() returns true with CI=true
• isRunningInContainer() returns true with CONTAINER=1
• isRunningInContainer() returns true with DOCKER_CONTAINER=1
• --docker flag routes to web/supervisor mode
• --web flag still works
• No flags = interactive mode
• Help text shows --docker documentation
• All existing CLI tests pass (0 regressions)
• Biome lint passes (0 errors)
• CLI build passes
• Run tinyclaw setup --docker in a container environment
• Verify auto-detection works by running in Docker without flags

Related Issue

Closes #12

Note: Supersedes #40 which was auto-closed after rebase force-push.

Checklist

• Code builds successfully (bun build)
• Tests pass (bun test)
• Documentation updated (help text)
• Follows Clean Commit convention
• CLA signed

[youhanasheriff]

Hey @warengonzaga, this PR is rebased on the latest dev branch and ready for review.

Changes from original #40:

• Rebased cleanly on latest dev (was 20+ commits behind)
• Fixed all Biome lint errors (import protocol, ordering, formatting)
• Deduplicated container detection into shared detect-container.ts
• All existing tests pass, build is clean

This supersedes #40 which was auto-closed after the rebase force-push. Sorry about that!

[warengonzaga]

It is indeed clean! The ones that you are seeing is that bot has no access to my keys. Looks like the action here does not use the latest action from main.

[Copilot]

Pull request overview

This PR adds a --docker CLI flag plus container auto-detection to route tinyclaw setup into the existing web-based setup flow, avoiding interactive prompt hangs in container/non-TTY environments.

Changes:

• Introduces isRunningInContainer() (env vars + /.dockerenv + /proc/1/cgroup) and reuses it across CLI entry + setup command.
• Adds --docker flag and updates CLI help text to document Docker/container behavior.
• Adds unit tests for container detection logic via Bun module mocking.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
src/cli/src/index.ts	Adds --docker flag + container auto-detection and routes setup to “web mode” path.
src/cli/src/detect-container.ts	New shared container detection helper (isRunningInContainer).
src/cli/src/commands/setup.ts	Adds an interactive warning/confirmation when a container environment is detected.
src/cli/tests/detect-container.test.ts	New unit tests covering env, /.dockerenv, and cgroup detection behaviors.

Comments suppressed due to low confidence (1)

src/cli/src/index.ts:79

• The new --docker flag and container auto-detection path in the router aren’t covered by the existing CLI router tests (which already cover --help/--version/unknown command). Adding coverage for tinyclaw setup --docker and for auto-detect (by setting env/fixtures) would help prevent regressions in this routing logic.

    case 'setup': {
      // Detect Docker/container environment and auto-route to web mode
      const isDocker = args.includes('--docker') || isRunningInContainer();
      const isWeb = args.includes('--web') || isDocker;

      if (isWeb) {
        // Web setup goes through supervisor so the restart mechanism works
        const { supervisedStart } = await import('./supervisor.js');
        await supervisedStart();
        break;
      }

      const { setupCommand } = await import('./commands/setup.js');
      await setupCommand();
      break;
    }

---

You can also share your feedback on Copilot code review. Take the survey.

[warengonzaga]

Hey @youhanasheriff thank you for your patience for me to review this.

[warengonzaga]

@youhanasheriff kindly check the review from copilot to see if it fits your changes.