docs: Improve installation instructions with post-install steps and troubleshooting

[visahak]

Problem

Users reported modes not appearing after installation because the restart requirement wasn't documented.

Changes

• Added explicit restart requirement for Bob IDE after installation
• Added post-installation verification steps for all platforms
• Added troubleshooting section for common issues
• Clarified what gets installed and where files are located
• Updated Hello World tutorial with troubleshooting guidance

Impact

Addresses user feedback about unclear installation process and reduces support burden.

Summary by CodeRabbit

• New Features

  • Added Codex platform integration with Evolve Lite capabilities
  • Extended sandbox environment to support both Claude Code and Codex workflows
  • Added OpenAI API key environment variable support

• Documentation

  • New comprehensive installation and setup guides with troubleshooting sections
  • Added Codex integration documentation with configuration and workflow examples
  • Enhanced post-installation verification steps for both platforms
  • Improved skill documentation for entity extraction and error detection workflows

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR introduces Codex IDE integration alongside existing Claude Code support. It includes multi-stage Docker builds for both platforms, adds Codex-specific bootstrap and entrypoint scripts, renames Claude-related build targets, creates new Codex targets in the justfile, expands documentation with setup and usage guides, and adds Evolve Lite Codex integration documentation.

Changes

Cohort / File(s)	Summary
Documentation – Integration Guides docs/integrations/evolve-lite-codex.md, docs/integrations/claude/evolve-lite.md	New Codex integration guide with prerequisites, installation, configuration, workflow actions, entity storage model, and capability comparison; updated Claude integration docs to use claude-prompt command.
Documentation – Installation & Examples docs/installation/index.md, docs/examples/hello_world/bob.md	Added post-install steps, platform-specific verification, troubleshooting sections for Bob IDE and plugin verification, and clarified install script scope.
Dockerfile Multi-Stage Refactoring sandbox/Dockerfile	Introduced shared base stage with common utilities, split into claude and codex targets; codex target installs Node.js/npm, Codex CLI, and bootstrap scripts with custom entrypoint.
Justfile Build & Run Targets justfile	Renamed image variable to claude_image, added codex_image; renamed Claude targets (sandbox-run → claude-run, sandbox-prompt → claude-prompt, sandbox-test → claude-test); added conditional build/clean targets; introduced codex-run and codex-test targets.
Codex Sandbox Setup Scripts sandbox/codex/bootstrap_codex_config.py, sandbox/codex/entrypoint.sh	New Python script to configure Codex TOML settings (cli_auth_credentials_store, codex_hooks); new shell entrypoint to set environment variables and bootstrap config before delegating to command.
Documentation – Sandbox Usage sandbox/README.md	Expanded scope to cover both Claude Code and Codex sandboxes; replaced direct Docker commands with just task workflow; added plugin invocation examples, authentication guidance, and external walkthrough links.
Configuration & Baseline sandbox/sample.env, .secrets.baseline	Added OPENAI_API_KEY environment variable; updated secrets baseline with new detected entry for sample.env.
Skill Documentation platform-integrations/codex/plugins/evolve-lite/skills/learn/SKILL.md	Shifted focus from generating guidelines to extracting proactive entities prioritizing errors/failures; added error-signals list, structured table schema, rationale field in JSON output; expanded examples and best practices.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• feat(platform-integrations): add codex evolve-lite installer #111 — Adds foundational Codex "evolve-lite" integration artifacts (plugin/skill documentation, sandbox bootstrap scripts, Dockerfile support).
• docs(codex): update evolve-lite learn skill guidance #143 — Updates the same learn skill documentation file (platform-integrations/codex/plugins/evolve-lite/skills/learn/SKILL.md) with guidance refinements.
• docs(repo): reorganize documentation structure #131 — Overlaps on documentation updates (docs/installation/index.md, Evolve Lite guides) and .secrets.baseline modifications.

Suggested reviewers

• gaodan-fang
• illeatmyhat

Poem

🐰 hops with delight
Two IDEs now dance through Docker's stages bright,
Claude and Codex unite in the Evolve Lite light! 🌟
Bootstrap scripts whisper, entrypoints align,
Justfile targets renamed—the architecture's design! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main documentation changes: improving installation instructions with explicit post-install steps and troubleshooting guidance, which are substantive additions across multiple documentation files.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}