Skip to content

Docs/update readme and changelog#132

Merged
haofeif merged 13 commits into
mainfrom
docs/update-readme-and-changelog
Mar 26, 2026
Merged

Docs/update readme and changelog#132
haofeif merged 13 commits into
mainfrom
docs/update-readme-and-changelog

Conversation

@haofeif

@haofeif haofeif commented Mar 26, 2026

Copy link
Copy Markdown
Contributor

Summary

  • CHANGELOG.md: Add v2.0.0 changelog covering all changes since v1.1.0 — 3 new providers (Gemini CLI, Kimi CLI, Copilot CLI), Web UI dashboard, cross-provider orchestration, auto-inject sender terminal ID, 8 bug fixes, 7 security improvements
  • Web UI documentation: Add web/README.md (frontend architecture, tech stack, components, data flow) and docs/settings.md (agent directory configuration, settings.json format, API endpoints). Clarify in root README.md that Web UI requires a cloned repo
  • Cross-provider examples: Add supervisor profile, report generator (Codex), additional data analyst variants (Codex, Copilot CLI), rewrite README with setup steps, example prompts, and customization guide
  • Claude Code auth fix: Preserve CLAUDE_CODE_USE_* and CLAUDE_CODE_SKIP_*_AUTH env vars (Bedrock, Vertex AI, Foundry) in tmux sessions — previously all CLAUDE* vars were stripped, breaking authentication
  • Agent directories: Add ~/.aws/cli-agent-orchestrator/agent-context/ to default directories so cao install-ed profiles appear in Web UI Settings

Changes

Documentation (7 files)

  • CHANGELOG.md — v2.0.0 release notes (2026-03-28)
  • README.md — Web UI clone instructions, dev/production mode clarification, links to new docs, add kimi_cli/copilot_cli to valid providers
  • web/README.md — Frontend architecture, React + Zustand + xterm.js + Tailwind, all pages/components, project structure
  • docs/settings.md — Settings service: agent directories, defaults, overrides, extra dirs, API endpoints
  • examples/cross-provider/README.md — Complete rewrite with setup, usage, customization guide
  • examples/cross-provider/cross_provider_supervisor.md — New supervisor profile (Claude Code + Gemini CLI + Kiro CLI workers)
  • examples/cross-provider/report_generator_codex.md, data_analyst_codex.md, data_analyst_copilot_cli.md — New worker profiles

Bug fix (2 files)

  • src/cli_agent_orchestrator/clients/tmux.py — Preserve 6 Claude Code auth env vars instead of stripping all CLAUDE*
  • src/cli_agent_orchestrator/providers/claude_code.py — Same fix in shell unset command

Enhancement (2 files)

  • src/cli_agent_orchestrator/services/settings_service.py — Add cao_installed to default agent directories
  • src/cli_agent_orchestrator/utils/agent_profiles.py — Add installed source label for cao_installed directory

Test plan

  • All 1022 unit tests pass
  • All 8 Claude Code e2e tests pass (handoff, assign, send_message, supervisor orchestration)
  • Verified CLAUDE_CODE_USE_BEDROCK preserved in tmux sessions — Claude Code authenticates without /login
  • Verified grep pattern correctly preserves 6 auth vars while stripping other CLAUDE* vars
  • agent-context directory appears in Web UI Settings page

haofeif and others added 13 commits March 26, 2026 11:30
- Add CHANGELOG entry for v2.0.0 covering all changes since v1.1.0:
  3 new providers (Gemini CLI, Kimi CLI, Copilot CLI), Web UI dashboard,
  provider override in agent profiles, auto-inject sender terminal ID,
  security fixes, and dependency bumps.
- Clarify Web UI README section: note that commands assume project root
  directory, add "In a new terminal" hint for step 2.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The cross-provider example only had worker profiles with provider
overrides but no supervisor profile showing how to use them. Added
cross_provider_supervisor.md and updated README with installation
and usage instructions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add report_generator_codex.md with codex provider override
- Update cross_provider_supervisor.md to use report_generator_codex
  for the handoff step, demonstrating 4 providers in one workflow
  (Claude Code, Gemini CLI, Kiro CLI for assign + Codex for handoff)
- Update README with the new profile and installation step

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…cription

- Update README cross-provider section: add kimi_cli and copilot_cli
  to the valid provider values list
- Fix cross_provider_supervisor.md description to include Codex

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Add data_analyst_codex.md and data_analyst_copilot_cli.md for full
  provider coverage
- Rewrite cross_provider_supervisor.md to make clear you pick the
  worker profiles matching your installed providers — not all required
- Split README profiles table into Supervisor / Data Analysts / Report
  Generator sections with guidance on selecting the right ones
- Show commented-out install lines so users can uncomment what they need

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…uide

Supervisor now references claude_code, gemini_cli, and kiro_cli by
default (plus report_generator_codex for handoff). README explains how
to customize the supervisor to use other providers like codex or
copilot_cli, and how to create your own cross-provider profiles.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Match the structure of examples/assign/README.md: add cao-server start
step, numbered setup instructions, all provider launch variants, and
the example task prompt for the supervisor terminal.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…URLs

Restructure the Web UI section into Option A (dev mode) and Option B
(production mode) with explicit "open browser" instructions for each.
Remove duplicated build section. Move remote/SSH instructions to the end.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
cao install copies profiles to ~/.aws/cli-agent-orchestrator/agent-context/
but this directory was not scanned by agent_profiles.py or shown in the
Web UI settings. Add it as 'cao_installed' in the default agent directories
so installed profiles are discoverable.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…ssions

When CAO spawns Claude Code in tmux, it strips all CLAUDE* env vars to
prevent "nested session" errors. This also removes CLAUDE_CODE_USE_BEDROCK,
which is required for Bedrock authentication, causing Claude Code to show
"Not logged in". Preserve this specific var in both tmux.py (env filter)
and claude_code.py (shell unset command).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…Bedrock

The env var is needed for all authentication modes (Bedrock, custom
models, and default Claude Code credentials), not just Bedrock.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Users who installed via `uv tool install` don't have the web/ directory.
Added a note with clone instructions at the top of the Web UI section.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…uth env vars

- web/README.md: frontend architecture, tech stack, components, data flow
- docs/settings.md: agent directory configuration, settings.json format, API
- README.md: link to new docs, clarify Web UI requires cloned repo
- CHANGELOG.md: update v2.0.0 release date to 2026-03-28
- tmux.py + claude_code.py: preserve all CLAUDE_CODE_USE_* and
  CLAUDE_CODE_SKIP_*_AUTH env vars (Bedrock, Vertex AI, Foundry)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@haofeif haofeif merged commit c5d7216 into main Mar 26, 2026
16 checks passed
@haofeif haofeif deleted the docs/update-readme-and-changelog branch March 26, 2026 13:46
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.

1 participant