github-code/claude-howto
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: sync to Claude Code v2.1.101 with /team-onboarding, /ultraplan, Monitor tool (#73)

Browse Source 
* docs: sync to Claude Code v2.1.101 with new feature coverage

Bumps all English docs from v2.1.97 to v2.1.101, adds mandatory Sources
footer block (previously missing), and documents three new features
shipped between v2.1.98 and v2.1.101:

- /team-onboarding (v2.1.101) — new built-in command for generating
  teammate ramp-up guides. Added to 01-slash-commands and CATALOG.
- /ultraplan (v2.1.91+, cloud-env auto-creation in v2.1.101) — full
  section in 09-advanced-features covering launch methods, status
  indicators, and execution options. Replaces prior 3-line stub.
- Monitor tool (v2.1.98) — full section in 09-advanced-features with
  stream-filter and poll-emit patterns and the grep --line-buffered
  warning. Added to resources.md feature table.

Vietnamese and Chinese translations are not touched in this sync.

* fix(docs): address review feedback on v2.1.101 sync

- Correct /team-onboarding availability date (April 10 → April 11, 2026)
- Fix uninitialized \$last variable in Monitor poll-and-emit example
- Update CATALOG.md New Features heading to April 2026 and add Monitor
  Tool, /team-onboarding, and Ultraplan auto-create entries
This commit is contained in:
Luong NGUYEN
2026-04-11 22:30:46 +02:00
committed by GitHub
parent 63a1416884
commit 2deba3ac2f
17 changed files with 231 additions and 61 deletions
Download Patch File Download Diff File Expand all files Collapse all files

149
09-advanced-features/README.md
View File

@@ -11,29 +11,31 @@ Comprehensive guide to Claude Code's advanced capabilities including planning mo
1. [Overview](#overview)
2. [Planning Mode](#planning-mode)
3. [Extended Thinking](#extended-thinking)
4. [Auto Mode](#auto-mode)
5. [Background Tasks](#background-tasks)
6. [Scheduled Tasks](#scheduled-tasks)
7. [Permission Modes](#permission-modes)
8. [Headless Mode](#headless-mode)
9. [Session Management](#session-management)
10. [Interactive Features](#interactive-features)
11. [Voice Dictation](#voice-dictation)
12. [Channels](#channels)
13. [Chrome Integration](#chrome-integration)
14. [Remote Control](#remote-control)
15. [Web Sessions](#web-sessions)
16. [Desktop App](#desktop-app)
17. [Task List](#task-list)
18. [Prompt Suggestions](#prompt-suggestions)
19. [Git Worktrees](#git-worktrees)
20. [Sandboxing](#sandboxing)
21. [Managed Settings (Enterprise)](#managed-settings-enterprise)
22. [Configuration and Settings](#configuration-and-settings)
23. [Agent Teams](#agent-teams)
24. [Best Practices](#best-practices)
25. [Additional Resources](#additional-resources)
3. [Ultraplan (Cloud Plan Drafting)](#ultraplan-cloud-plan-drafting)
4. [Extended Thinking](#extended-thinking)
5. [Auto Mode](#auto-mode)
6. [Background Tasks](#background-tasks)
7. [Monitor Tool (Event-Driven Streams)](#monitor-tool-event-driven-streams)
8. [Scheduled Tasks](#scheduled-tasks)
9. [Permission Modes](#permission-modes)
10. [Headless Mode](#headless-mode)
11. [Session Management](#session-management)
12. [Interactive Features](#interactive-features)
13. [Voice Dictation](#voice-dictation)
14. [Channels](#channels)
15. [Chrome Integration](#chrome-integration)
16. [Remote Control](#remote-control)
17. [Web Sessions](#web-sessions)
18. [Desktop App](#desktop-app)
19. [Task List](#task-list)
20. [Prompt Suggestions](#prompt-suggestions)
21. [Git Worktrees](#git-worktrees)
22. [Sandboxing](#sandboxing)
23. [Managed Settings (Enterprise)](#managed-settings-enterprise)
24. [Configuration and Settings](#configuration-and-settings)
25. [Agent Teams](#agent-teams)
26. [Best Practices](#best-practices)
27. [Additional Resources](#additional-resources)
---
@@ -197,9 +199,59 @@ claude --model opusplan "design and implement the new API"
**Edit plan externally**: Press `Ctrl+G` to open the current plan in your external editor for detailed modifications.
### Ultraplan
---
Use `/ultraplan <prompt>` for an end-to-end planning workflow: Claude drafts a detailed plan, opens it in the browser for review, then executes the plan either remotely or sends it back to your terminal for local execution.
## Ultraplan (Cloud Plan Drafting)
> **New in v2.1.101**: Ultraplan now auto-creates a Claude Code on the web cloud environment the first time you invoke it — no manual setup, no waiting for a container to warm up before the draft starts.
> **Note**: Ultraplan is a research preview and requires Claude Code v2.1.91 or newer.
`/ultraplan` hands a planning task from your local CLI to a Claude Code on the web session running in plan mode. Claude drafts the plan in the cloud while your terminal stays free for other work, then you review the draft in the browser and choose where to execute — in the same cloud session or teleported back to your terminal.
### When to Use Ultraplan
- You want a richer review surface than the terminal: inline comments, emoji reactions, an outline sidebar, and persistent history.
- You want hands-off drafting while you keep coding locally — the cloud session researches the repo and writes the plan without blocking your CLI.
- The plan needs stakeholder review before execution — a shareable web URL beats pasting terminal scrollback.
### Requirements
- A Claude Code on the web account.
- A GitHub repository (the cloud session clones your repo to draft against real code).
- **Not available** on Amazon Bedrock, Google Cloud Vertex AI, or Microsoft Foundry.
### Three Ways to Launch
- **Command**: `/ultraplan <prompt>` — explicit invocation.
- **Keyword**: include the word `ultraplan` anywhere in a normal prompt and Claude routes the request to the cloud.
- **From a local plan**: after Claude finishes a plan locally, pick "No, refine with Ultraplan on Claude Code on the web" in the approval dialog to hand the draft off for deeper research.
### Usage Example
```bash
/ultraplan migrate the auth service from sessions to JWTs
```
Claude acknowledges, spins up the cloud environment (auto-created on first run in v2.1.101+), and returns a session link you can open in your browser.
### Status Indicators
| Status | Meaning |
|---|---|
| `◇ ultraplan` | Claude is researching your codebase and drafting the plan |
| `◇ ultraplan needs your input` | Claude has a clarifying question; open the session link to respond |
| `◆ ultraplan ready` | The plan is ready to review in your browser |
### Execution Options
Once the plan is ready, you have two execution paths. Approve the plan in the browser to execute in the same cloud session — Claude implements the changes remotely and opens a pull request from the web UI. Or choose "Approve plan and teleport back to terminal" to implement locally. The terminal teleport dialog offers three choices:
- **Implement here** — run the approved plan in your current terminal session.
- **Start new session** — open a fresh session in the same working directory and implement there.
- **Cancel** — saves the plan to a file so you can pick it up later.
> **Warning**: Remote Control disconnects when ultraplan starts. Both features share the claude.ai/code interface, so only one can be active at a time.
---
@@ -591,6 +643,43 @@ Claude: [Shows linter output from bg-5002]
---
## Monitor Tool (Event-Driven Streams)
> **New in v2.1.98**: The Monitor tool lets Claude watch a background command's stdout and react the moment a matching event appears — replacing polling loops and `sleep` for waiting on long-running processes.
Monitor attaches to any shell command that writes to stdout. Each stdout line from the command becomes a notification that wakes the session. Claude specifies the command; the harness streams output and delivers events as they fire. See the related [Background Tasks](#background-tasks) section for launching the underlying processes.
### Why It Matters
Polling with `/loop` or `sleep` burns a full API round-trip every cycle, whether or not anything changed. Monitor stays silent until an event fires, consuming **zero tokens** while the command is quiet. When an event does occur, Claude reacts immediately — no delayed discovery waiting for the next poll tick. For anything that runs longer than a few minutes, this is both cheaper and faster than poll loops.
### Two Common Patterns
**Stream filters** watch continuous output from a long-running source. The command runs forever; every matching line is an event.
```bash
tail -f /var/log/app.log | grep --line-buffered "ERROR"
```
**Poll-and-emit filters** check a source periodically and only emit when something changes. Use this for APIs, databases, or anything without a native stream.
```bash
last=$(date -u +%Y-%m-%dT%H:%M:%SZ)
while true; do
gh api "repos/owner/repo/issues/123/comments?since=$last" || true
last=$(date -u +%Y-%m-%dT%H:%M:%SZ)
sleep 30
done
```
### Concrete Example
"Start my dev server and monitor it for errors." Claude launches the server as a background task, attaches a Monitor filter (`tail -F server.log | grep --line-buffered -E "ERROR|FATAL"`), and the session goes quiet. The moment an error line appears in the log, Claude wakes up, reads the error, and can react — restart the server, fix the bug, or surface it to you — without you having to check in.
> **Warning**: When piping into `grep`, **always** use `grep --line-buffered`. Without it, grep buffers stdout in 4KB chunks, which can delay events by minutes on low-traffic streams. This is the #1 way Monitor breaks in practice — if your filter seems silent when it shouldn't be, check for the `--line-buffered` flag first.
---
## Scheduled Tasks
Scheduled Tasks let you run prompts automatically on a recurring schedule or as one-time reminders. Tasks are session-scoped — they run while Claude Code is active and are cleared when the session ends. Available since v2.1.72+.
@@ -1940,6 +2029,12 @@ For more information about Claude Code and related features:
- [Official Agent Teams Documentation](https://code.claude.com/docs/en/agent-teams)
---
**Last Updated**: April 9, 2026
**Claude Code Version**: 2.1.97
**Last Updated**: April 11, 2026
**Claude Code Version**: 2.1.101
**Sources**:
- https://code.claude.com/docs/en/ultraplan
- https://code.claude.com/docs/en/tools-reference
- https://code.claude.com/docs/en/scheduled-tasks
- https://code.claude.com/docs/en/remote-control
- https://code.claude.com/docs/en/agent-teams
**Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5