docs: sync all documentation to current state (2026-04-28)
HELP.md: - Replace stale "Agent Mode" section with accurate "Tools (⚡)" section including full tool table (27 tools across 9 categories) - Fix header controls table: distinguish Context & Memory panel (sliders) from Settings dropdown (☰) - Update Settings panel section: "Backend" → "Role", add S/M/L and ⌃↵ to Display controls list - Update Backends section to match Role toggle terminology TODO__Agents.md: - Mark 5 new journal tools as complete (ae_journal_list, entry_update, entry_disable, entry_append, entry_prepend) - Add completed sections for: shell_exec tool, Tools toggle decoupling, UI input area polish (2026-04-28) MASTER.md: - Date: 2026-04-27 → 2026-04-28 - Orchestrator row: "Agent mode in UI" → "⚡ Tools toggle in UI (27 tools)" CLAUDE.md: - Date: 2026-04-03 → 2026-04-28 - Add orchestrator row to Current State table - Add full 27-tool list for quick reference Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Scott Idem
@@ -6,7 +6,7 @@
|
||||
and are appended automatically by help.html when present.
|
||||
-->
|
||||
|
||||
*Last updated: 2026-04-27*
|
||||
*Last updated: 2026-04-28*
|
||||
|
||||
---
|
||||
|
||||
@@ -15,21 +15,21 @@
|
||||
| Button | What it does |
|
||||
|---|---|
|
||||
| **Sessions** | Open the sessions panel — list, resume, or start sessions |
|
||||
| **Files** | Open the identity file editor (SOUL, MEMORY, etc.) |
|
||||
| **⚙ N** | Open the Settings panel (N = current context tier) |
|
||||
| **N** (sliders icon) | Open the Context & Memory panel (N = current context tier) |
|
||||
| **☰** | Settings menu — Files, Account, Sign Out |
|
||||
| **?** | Open this help panel |
|
||||
|
||||
The **⚙ Settings** panel contains all configuration options:
|
||||
The **Context & Memory** panel (sliders icon with tier number) contains all configuration options:
|
||||
|
||||
| Section | Controls |
|
||||
|---|---|
|
||||
| **Context Tier** | T1 – T4 context depth |
|
||||
| **Memory Layers** | Toggle Long / Mid / Short memory on/off |
|
||||
| **Distill Memory** | Manually trigger short / mid / long / all distillation |
|
||||
| **Backend** | Active LLM backend — click to cycle: claude → gemini → local → auto |
|
||||
| **Display** | Aa/A+/A− font size cycle · ☾/☀ theme toggle |
|
||||
| **Distill Memory** | Manually trigger Short / Mid / Long / All distillation |
|
||||
| **Role** | Active LLM role — click to cycle through configured role assignments |
|
||||
| **Display** | **Aa** cycles font size · **☾** toggles theme · **S/M/L** cycles input area height · **⌃↵** toggles send shortcut |
|
||||
|
||||
All header settings (theme, font size, tier, memory layers) persist in `localStorage` across page refreshes.
|
||||
All settings persist in `localStorage` across page refreshes.
|
||||
|
||||
---
|
||||
|
||||
@@ -46,22 +46,36 @@ Each assistant response shows a small **model tag** in the bottom-right corner i
|
||||
|
||||
---
|
||||
|
||||
## Agent Mode
|
||||
## Tools (⚡)
|
||||
|
||||
Click the **Agent** button in the input row to enable Agent mode. The button highlights and Send changes to **Run**.
|
||||
Click the **⚡** button in the input row to enable the Tools toggle. When lit (amber), **Send** changes to **Run** and messages are routed through the **orchestrator** instead of directly to the chat model.
|
||||
|
||||
In Agent mode, messages are routed through the **orchestrator** instead of directly to the chat model:
|
||||
The orchestrator runs a multi-step tool loop:
|
||||
|
||||
1. The **orchestrator model** runs a tool loop — searches the web, reads files, checks tasks, calls APIs as needed
|
||||
1. The **orchestrator model** reasons about the request and calls tools as needed — web search, file reads, task management, shell commands, Aether Journals, and more
|
||||
2. It produces an enriched summary of what it found
|
||||
3. The **responder model** receives that context and writes the final user-facing reply
|
||||
3. The **responder model** (set by the active Role) receives that context and writes the final user-facing reply
|
||||
4. A `⚡ N tool calls: …` note appears below the response listing what was used
|
||||
|
||||
Which model acts as orchestrator is set in **Settings → Models → Role Assignments → Orchestrator**. By default this is Gemini API; a capable local model can be assigned instead.
|
||||
The ⚡ toggle is **independent of the Role selector** — you can use any role (chat, coder, research, etc.) with or without tools. The orchestrator model is configured in **Account → Model Registry → Role Assignments → Orchestrator**. By default this is Gemini API.
|
||||
|
||||
Agent mode is best for tasks that require research, multi-step reasoning, or tool use (e.g. "search for X", "add a task", "what's on my list?"). Regular chat is faster for conversational turns.
|
||||
**Available tools:**
|
||||
|
||||
Agent mode sessions persist to history exactly like regular chat.
|
||||
| Category | Tools |
|
||||
|---|---|
|
||||
| Web | `web_search` |
|
||||
| Files | `file_read` |
|
||||
| Shell | `shell_exec`, `claude_allow_dir` |
|
||||
| Tasks | `task_list`, `task_create`, `task_update`, `task_complete` |
|
||||
| Cron | `cron_list`, `cron_add`, `cron_remove`, `cron_toggle` |
|
||||
| Reminders | `reminders_add`, `reminders_list`, `reminders_clear` |
|
||||
| Scratchpad | `scratch_read`, `scratch_write`, `scratch_append`, `scratch_clear` |
|
||||
| Aether Journals | `ae_journal_list`, `ae_journal_search`, `ae_journal_entry_create`, `ae_journal_entry_update`, `ae_journal_entry_disable`, `ae_journal_entry_append`, `ae_journal_entry_prepend` |
|
||||
| Aether Tasks | `ae_task_list` |
|
||||
|
||||
Tools mode is best for tasks requiring research, multi-step reasoning, or side effects (e.g. "search for X", "add a task", "what's on my list?", "append this to my journal"). Regular chat is faster for conversational turns.
|
||||
|
||||
Orchestrated sessions persist to history exactly like regular chat.
|
||||
|
||||
---
|
||||
|
||||
@@ -97,11 +111,11 @@ Three backends are available:
|
||||
| **Gemini** | Google Gemini via the Gemini CLI |
|
||||
| **Local** | Any OpenAI-compatible endpoint (Open WebUI, Ollama, OpenRouter, etc.) |
|
||||
|
||||
The **⚙ Backend** toggle cycles: **auto → claude → gemini → local → auto**
|
||||
The **Role** toggle in the Context & Memory panel cycles through configured role assignments. Each role maps to a Primary / Backup 1 / Backup 2 model chain set in the Model Registry.
|
||||
|
||||
- **auto** uses the model assigned to the `chat` role in your Model Registry (recommended)
|
||||
- Selecting a specific backend forces that backend for all messages, regardless of role assignments
|
||||
- The active model label appears below the toggle button when a specific backend is active
|
||||
- The active model label appears below the toggle button
|
||||
- `auto` (default) uses the model assigned to the `chat` role in your Model Registry
|
||||
- Forcing a specific backend overrides the role assignment for that session
|
||||
|
||||
If the active backend fails, a fallback is tried automatically. A **⚡** badge appears on the response when this happens.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user