diff --git a/README.md b/README.md index 6a5ade5c9a..262ed1b8d8 100644 --- a/README.md +++ b/README.md @@ -36,6 +36,7 @@ Open source, multi-provider, no telemetry, not tied to any cloud. - **Integrated workspace** - Built-in terminal, code editor with LSP, git changes panel, embedded vscode and chat in one IDE-like view - **Kanban task management** - Drag-and-drop boards, columns, and workflow automation - **Agentic workflows** - Multi-step pipelines that mix-and-match agents per step - for example, Claude Code Opus to design a plan, GitHub Copilot Sonnet to implement it, and Codex GPT 5.4 to review the changes. See [docs/workflow-tips.md](docs/workflow-tips.md) +- **Automations** - Trigger agent tasks on schedules or webhooks, with configurable run destinations, context, and concurrency - **Sub-tasks** - Agents can spawn sub-tasks that resume from the parent task's session. Useful for splitting a task that has grown too big, or producing several PRs from the same starting point. - **CLI passthrough** - Drop into raw agent CLI mode for direct terminal interaction with agents that support it, leveraging their full native TUI - **Workspace isolation** - Git worktrees prevent concurrent agents from conflicting @@ -44,6 +45,7 @@ Open source, multi-provider, no telemetry, not tied to any cloud. - **Runtime settings** - Executor profiles, secrets, custom prompts, utility agents, and resource metrics are configurable from Settings - **Task-agent MCP** - Agents can create subtasks, target sibling repos, attach extra branches for multiple PRs, message other tasks, read conversations, and inspect related tasks - **External MCP** - Manage Kandev from outside coding agents over streamable HTTP or SSE, with copyable config snippets for popular agent CLIs +- **Plugin marketplace and management** - Browse, install, update, enable, disable, and configure plugins from Settings, including MCP Explorer and the [Bitbucket plugin](https://github.com/kdlbs/kandev-plugin-bitbucket) - **Workflow portability** - Export and import workflows as portable YAML across workspaces or Kandev installs - **Session management** - Resume and review agent conversations - **Shareable task snapshots** - Publish redacted task conversation snapshots as secret GitHub Gists, with preview and revoke controls @@ -63,10 +65,11 @@ We're working on **Office mode**, a feature-flagged autonomy layer for persisten Linear Sentry GitLab + Azure DevOps Slack

-Connect Kandev to the tools your team already uses — pull issues into the kanban, link tasks to PRs, and surface review activity inline. +Connect Kandev to GitHub, GitLab, Jira, Linear, Sentry, and Azure DevOps to pull issues into the kanban, link tasks to PRs, and surface review activity inline. Bitbucket support is available through the [Bitbucket plugin](https://github.com/kdlbs/kandev-plugin-bitbucket). ## Supported ACP Agents diff --git a/docs/public/agents-and-profiles.md b/docs/public/agents-and-profiles.md index 15535eabeb..0a1958fa58 100644 --- a/docs/public/agents-and-profiles.md +++ b/docs/public/agents-and-profiles.md @@ -20,6 +20,8 @@ Agent authentication is separate from repository and integration credentials. Open **Settings > Agents** (`/settings/agents`). Kandev scans the host on which its backend runs, not the browser computer. +![Settings > Agents showing detected agent CLIs, profiles, configured status, unavailable status, update indicators, and New profile controls.](../screenshots/settings-agents.png) + The production registry currently shows Auggie, Claude, Codex, Copilot, Gemini, OpenCode, Amp, Qwen, iFlow (beta), Droid, Kilocode, Pi, Cursor, Kimi, Kiro, Qoder, Trae, `omp`, Devin, Grok, and Hermes. An entry is usable only when its executable is supported on the current platform and available to the Kandev process. Development and E2E profiles can add mock agents that are not product integrations. Hermes launches with `hermes acp`. Install the required `hermes` executable from its **Settings > Agents** card, which runs the official Hermes installer. Hermes currently supports task and workspace sessions. Office-assigned skill injection is not yet supported. diff --git a/docs/public/automation-and-mcp.md b/docs/public/automation-and-mcp.md index 08abfac1ae..74b1ebc345 100644 --- a/docs/public/automation-and-mcp.md +++ b/docs/public/automation-and-mcp.md @@ -39,6 +39,8 @@ See [Tasks and workflows](tasks-and-workflows.md) for event configuration and de Open **Settings > Workspaces > _Workspace_ > Automations** (`/settings/workspace/{workspaceId}/automations`) and select **New Automation**. The top-level `/settings/automations` route redirects to, or asks you to select, a workspace. +![Settings > Workspaces > Default > Automations showing enabled scheduled and webhook automations, export, new automation, and run actions.](../screenshots/automation-list.png) + 1. Enter a required name and optional description. 2. Select an agent profile and executor profile. Passthrough profiles are not offered. Worktree and Local-compatible profiles can run without a repository in a task-owned scratch workspace. 3. Choose the run destination: @@ -53,6 +55,8 @@ Open **Settings > Workspaces > _Workspace_ > Automations** (`/settings/workspace 8. Choose a schedule and optional GitHub condition, or switch to webhook mode. 9. Save, use **Run now** on the automation's page, then read what it said before widening credentials or scope. +![Automation editor showing repository access, run destination, context between runs, concurrency, and Save changes.](../screenshots/automation-editor.png) + The form can save an empty agent or executor selection, but launch still needs a usable profile. Scheduled, manual, webhook, and provider-triggered runs can remain repository-free. When a provider event supplies an exact repository through its established contract, Kandev uses that event context. A GitHub pull-request run with configured repository access checks out that PR's head branch and uses its base branch. ### What a firing produces @@ -174,6 +178,8 @@ Trigger payloads are untrusted input. Do not let a PR body or webhook field sile **Automations** in the sidebar lists the workspace's automations with a health dot. Picking one opens it. **`/automations`** is the agenda across all of them, what fires next, and the recent runs of every automation in one feed. **`/automations/`** is one automation's conversation: it opens on the newest run's transcript, carries the run's title snapshot and a reply box, and groups runs as Running / Completed in a rail or mobile drawer. A selected open run exposes **Stop current run**, which cancels its exact task, session, and turn without touching another run in a shared session. Configuration is behind **Details**, because an automation is configured once and read continuously. +![Kandev sidebar showing the Automations section with workspace automation shortcuts.](../screenshots/automation-sidebar.png) + `/runs` still resolves to the same places, so older links keep working. ## Concurrency, history, and cleanup diff --git a/docs/public/configuration.md b/docs/public/configuration.md index 94f9099b11..b3cc4a5511 100644 --- a/docs/public/configuration.md +++ b/docs/public/configuration.md @@ -493,7 +493,7 @@ Plugins are part of the base product and are not a runtime toggle. The source checkout's `make dev` activates the embedded development profile, which enables Office, debug surfaces, ACP logging, and a mock agent; authentication and Claude background prompt handoff remain opt-in. Installed `run`/desktop builds select the safe production profile unless the environment explicitly opts in. E2E mock variables and routes are test-only and must never be enabled on a public deployment. ## Credentials and product settings -The **Unread Messages** preference in **Settings > General > Task Actions** controls the Slack-style **New** divider in session transcripts. It defaults off for each user, persists with user settings, and takes effect immediately. Enabling it also allows that user's active transcript view to advance the session read cursor. +The **Unread Messages** preference in **Settings > Preferences > Task Behavior** controls the Slack-style **New** divider in session transcripts. It defaults off for each user, persists with user settings, and takes effect immediately. Enabling it also allows that user's active transcript view to advance the session read cursor. Most integrations, executor profiles, agent profiles, MCP servers, repository settings, and UI preferences are persistent database records edited under **Settings**. They are not fields in `config.yaml`. Secret values use an encrypted secret store backed by `/data/master.key`; filesystem permissions, database backups, and key backup are part of the security boundary. diff --git a/docs/public/developer-tools.md b/docs/public/developer-tools.md index 6506a459e4..d324bfff8e 100644 --- a/docs/public/developer-tools.md +++ b/docs/public/developer-tools.md @@ -47,7 +47,7 @@ Quick Chat supports multiple tabs, tab renaming, and **+** to open another ordin Your chats and their names are shared by every browser and device signed in to the same Kandev instance. Starting, renaming, or closing a chat on one device updates the others, and a device that was offline catches up when it reconnects. -When **Settings > General > Task Actions > Agent-generated task titles** is enabled, an ordinary +When **Settings > Preferences > Task Behavior > Agent-generated task titles** is enabled, an ordinary Quick Chat starts with its normal provisional label and its owner agent can replace that label with a short title based on your first request. Structured and CLI-passthrough chats receive the title instruction through their existing first-turn path. The new title appears on every connected device @@ -173,7 +173,7 @@ Open the context menu on any file or folder in the Files tree: right-click on de Use the workbench top bar's split-editor action to open the selected session worktree in the default editor. Its menu lets you choose another configured editor. A file's **Open with** menu can also open a specific editor, copy the path, or ask the operating system to show the folder. -Open **Settings > General > Editors** (`/settings/general/editors`) to set a default and configure integrations. Kandev discovers these built-in desktop editors when installed: +Open **Settings > Preferences > Terminal & Editors** (`/settings/preferences/terminal-editors`) to set a default and configure integrations. Kandev discovers these built-in desktop editors when installed: - Visual Studio Code - Zed @@ -193,7 +193,9 @@ Desktop editor discovery and custom commands run on the Kandev backend host. The ## Language servers -Language-server settings are part of **Settings > General > Editors**. Kandev currently registers servers for: +![Settings > Preferences > Terminal & Editors showing language-server cards, auto-start controls, status location, and server configuration.](../screenshots/settings-terminal-editors.png) + +Language-server settings are part of **Settings > Preferences > Terminal & Editors**. Kandev currently registers servers for: - TypeScript and JavaScript; - Go; @@ -239,7 +241,9 @@ On desktop, select **+ > Terminals > New Terminal**. Parked terminal sessions ca Do not confuse a user terminal with a CLI-passthrough agent tab: both use PTYs, but only the agent tab is the agent's native interface. `Cmd/Ctrl+J` toggles the bottom terminal area. -Open **Settings > General > Terminal** (`/settings/general/terminal`) to configure: +![Settings > Preferences > Terminal & Editors showing shell, terminal font, font size, and link settings.](../screenshots/settings-terminal.png) + +Open **Settings > Preferences > Terminal & Editors** (`/settings/preferences/terminal-editors`) to configure: - preferred shell, which defaults to the system shell; the built-in choices are zsh, bash, and sh on macOS/Linux, and PowerShell (`pwsh`), Windows PowerShell, and cmd on Windows, plus a custom executable; - terminal font, with a default Menlo/Monaco-style stack; diff --git a/docs/public/executors.md b/docs/public/executors.md index f6900918ab..8f1ed4159b 100644 --- a/docs/public/executors.md +++ b/docs/public/executors.md @@ -42,6 +42,8 @@ download requirements. Open **Settings > Executors**, then choose **Local**, **Worktree**, **Docker**, **Sprites.dev**, or **SSH** under **Create New Profile**. Local and Worktree profiles already exist in a new database. +![Settings > Executors showing existing Local, Worktree, and Sprites profiles plus Local, Worktree, Docker, Sprites.dev, and SSH profile creation options.](../screenshots/settings-executors.png) + Workspaces > _Workspace_ > Integrations**, then choose a provider. The direct routes are: +![Settings > Workspaces > Default > Integrations showing Azure DevOps, GitHub, GitLab, Jira, Linear, and Sentry connections.](../screenshots/settings-integrations.png) + - `/settings/workspace/{workspaceId}/integrations/github` - `/settings/workspace/{workspaceId}/integrations/gitlab` - `/settings/workspace/{workspaceId}/integrations/azure-devops` diff --git a/docs/public/operations.md b/docs/public/operations.md index cefbe83d6f..f0f407f43b 100644 --- a/docs/public/operations.md +++ b/docs/public/operations.md @@ -29,7 +29,7 @@ See [Desktop app](desktop-app.md), [CLI](cli.md), [Run as a service](run-as-a-se ## Prevent host sleep during active tasks -Administrators can open **Settings > General > Task Actions** and enable +Administrators can open **Settings > Preferences > Task Behavior** and enable **Prevent host sleep while tasks run**. The install-wide setting is off by default and is saved with the Kandev database. It applies only to the machine running the backend; it does not change executor or node power policy. @@ -56,6 +56,8 @@ availability policy instead. Enabling the preference is safe when moving the database between hosts: Kandev reacquires a native request only after startup if the new backend can provide it and a working task still exists. +![Settings > Preferences > Task Behavior showing task title, archive, unread message, and host sleep controls.](../screenshots/settings-task-behavior.png) + ## Health and readiness Use the top-level liveness endpoint for process supervisors: @@ -86,6 +88,8 @@ curl -fsS http://127.0.0.1:38429/api/v1/system/health This diagnostic checks the Git executable, GitHub authentication/rate limits, agent discovery, and Linux inotify pressure. It returns a JSON `healthy` field and issue list, but normally uses HTTP 200 even when `healthy` is false; do not substitute it for `/health` in a status-only probe. +![Settings > System > Status showing health checks, the running version, and disk usage.](../screenshots/system-status.png) + For a managed service, also check its process manager: ```bash @@ -133,12 +137,15 @@ The System Database and Backups pages use the configured SQLite file path. They
Storage maintenance details -Open **Settings > System > Storage** to inspect Kandev-managed disk usage and configure cleanup. +Open **Settings > System > Data & Logs**, then use the **Storage** section to +inspect Kandev-managed disk usage and configure cleanup. **Analyze** is read-only. **Run now** applies only the enabled cleanup rules and refuses to start while another maintenance run owns the cleanup gate. If task resources are active, the page names the active work and offers **Run anyway** after an explicit disruption warning. Use that override only when the active task work can tolerate cleanup running alongside it. +![Settings > System > Data & Logs, Storage section showing disk capacity, storage analysis, and cleanup controls.](../screenshots/system-storage.png) + Storage analysis results are cached in the running backend for 15 minutes, so page reloads and policy saves reuse the displayed snapshot instead of scanning disk again. The page shows when that snapshot was last analyzed. Select **Analyze** to force a fresh scan; restarting the backend also @@ -156,6 +163,8 @@ permanent deletion. Each entry shows its `delete_after` retention deadline: **De time, not an exact promise, the first successful scheduled or full manual maintenance run after the deadline performs the purge, subject to the idle gate and any preemption. +![Settings > System > Data & Logs showing the maintenance policy, schedule, workspace cleanup, and folder allowlist.](../screenshots/system-maintenance-policy.png) + Use **Clear eligible** to remove only entries whose deadlines have passed. It reports protected entries that remain. **Force clear all** requires typing `DELETE ALL NOW` and attempts to permanently remove every active quarantine entry, discarding restore windows for entries that are successfully @@ -163,6 +172,8 @@ deleted. Safety-validation or deletion failures may leave entries visible and re override bypasses only the retention timestamp; path, ownership, state, and filesystem safety checks still apply. +![Settings > System > Data & Logs showing quarantined resources with restore, delete, and force-clear controls.](../screenshots/system-quarantine.png) + Kandev keeps at most one restorable Go-cache generation for each original cache path. If that generation is still active when the replacement cache exceeds its limit, the next rotation is deferred. The maintenance run succeeds and reports `active_quarantine`; both the live cache and @@ -194,6 +205,8 @@ Host-wide Docker build-cache and unused-image cleanup remain disabled until you owns a dedicated Docker daemon. Do not enable those rules on a daemon shared with unrelated workloads. +![Settings > System > Data & Logs showing Docker cleanup controls, cache retention, unused image cleanup, and quarantine safety.](../screenshots/system-docker-cleanup.png) + The Storage page also reports **Kandev temporary artifacts** created by services that need a short-lived directory under the host temporary root. Each current artifact is registered in the Kandev database and carries an owner-only marker in its exact directory. Active artifacts and @@ -469,6 +482,8 @@ Collection starts only while at least one connected client displays metrics in t These metrics are lightweight UI observability. Set alerts, retention, CPU/memory limits, and disk quotas in the host, container platform, or external monitoring stack. +![Settings > Preferences > Appearance showing status-bar and resource-metrics controls.](../screenshots/settings-appearance.png) + ## Status bar visibility The status surface is off by default for each user. Open **Settings > Preferences > Appearance > Status Bar**, enable **Show status bar**, and use the page's shared **Save changes** action. The portable preference applies immediately without restarting Kandev. It shows a 24 px bottom bar on desktop and fine-pointer tablets; phones use native Status controls and an inset Status drawer. diff --git a/docs/public/plugins-marketplace.md b/docs/public/plugins-marketplace.md index e5370f2175..e6e2b507a1 100644 --- a/docs/public/plugins-marketplace.md +++ b/docs/public/plugins-marketplace.md @@ -47,6 +47,8 @@ Open **Settings > Plugins > Browse**. Each plugin shows as a card with its name, description, author, categories, source repository link, latest version, and GitHub star count. To narrow the list: +![Settings > Plugins > Browse showing the plugin marketplace with search, category, sort, install status, and repository links.](../screenshots/plugin-browse.png) + - **Search**: type in the search box to match plugin name or description. - **Category**: filter to a single category with the category dropdown. - **Sort**: **Most stars** (default), **Recently updated** (by latest release diff --git a/docs/public/plugins.md b/docs/public/plugins.md index d049d4e7ae..3133246c7b 100644 --- a/docs/public/plugins.md +++ b/docs/public/plugins.md @@ -148,6 +148,11 @@ a required setting that has no value yet: ![The Settings > Plugins page listing an installed, active plugin with its category, a Setup required badge, an unsigned badge, Disable/Uninstall actions, and a chevron opening the plugin's settings page.](../screenshots/plugin-settings-list.png) +The Installed tab also gives you an overview of automatic updates, installed +versions, available updates, and per-plugin controls: + +![Settings > Plugins showing automatic updates and the installed plugin list with sync, update, enable, disable, uninstall, and settings controls.](../screenshots/plugin-settings.png) +
Filesystem sideload and synchronization diff --git a/docs/public/sessions-and-review.md b/docs/public/sessions-and-review.md index 8acad13f38..c5ae659f83 100644 --- a/docs/public/sessions-and-review.md +++ b/docs/public/sessions-and-review.md @@ -119,7 +119,13 @@ the workspace-search shortcuts untouched. Click a mode or press **Tab** / search field. File matches are grouped by repository. Hover a mode to see its direct shortcut. -Open **Settings > General > Layouts** to configure reusable desktop workbench profiles. Select a tab in a built-in layout to reveal its nearby edit controls, arrange or remove tabs and splits, then use the floating **Save changes** control. Kandev keeps the built-in row visible, marks it **Customized**, and stores your override without requiring a duplicate. Choose **Reset** beside a customized built-in to restore its original definition. +Open **Settings > Preferences > Keyboard Shortcuts** to customize these bindings. + +![Settings > Preferences > Keyboard Shortcuts showing chat input and command panel bindings.](../screenshots/settings-keyboard-shortcuts.png) + +Open **Settings > Preferences > Layouts** to configure reusable desktop workbench profiles. Select a tab in a built-in layout to reveal its nearby edit controls, arrange or remove tabs and splits, then use the floating **Save changes** control. Kandev keeps the built-in row visible, marks it **Customized**, and stores your override without requiring a duplicate. Choose **Reset** beside a customized built-in to restore its original definition. + +![Settings > Preferences > Layouts showing built-in desktop workbench profiles and the Default layout editor.](../screenshots/settings-layouts.png) **PR Details** is a reusable Layouts panel whose visibility follows the active task's review association. Without a linked GitHub pull request or GitLab merge request, the tab stays hidden, even when the selected layout includes it. Once a review is linked, Kandev adds PR Details as an inactive tab: beside **Agent** for the built-in Default, or in the group and tab position you configured in the Layouts editor. Closing that tab prevents it from reappearing automatically in the same session. Changing the default applies to task environments without a saved task-specific layout and **Reset Layout**, not a layout already saved for a task. Removing Terminal from the Default layout also prevents Kandev from creating its initial user shell. diff --git a/docs/screenshots.md b/docs/screenshots.md index 56627a875e..f507b37d08 100644 --- a/docs/screenshots.md +++ b/docs/screenshots.md @@ -1,5 +1,169 @@ # Screenshots +## Table of contents + +- [Core workflow](#core-workflow) +- [Automations](#automations) +- [Plugins](#plugins) +- [Workspace & agent settings](#workspace--agent-settings) +- [Mobile](#mobile) +- [Preferences](#preferences) +- [System settings](#system-settings) + +## Core workflow + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Kanban
Kanban		Add Task
Add Task
Task Session
Task Session		Plan Mode
Plan Mode
Workflows
Workflows		Pipeline
Pipeline
Workflow Details
Workflow Details		File Editor
File Editor
Embedded VS Code
Embedded VS Code		Git Operations
Git Operations
Review PRs
Review PRs		Review Dialog
Review Dialog
+ PR auto-fix
+ Automate CI fixes, review-comment follow-up, and optional auto-merge or requeue when ready.

+ PR automation panel with auto-fix and auto-merge enabled + 		+ Agent updates and version notifications
+ Get a visible prompt when a managed agent runtime has a newer version.

+ Agent update notification showing a newer Codey version +
Plan Comments
Plan Comments		CLI Agent
CLI Agent
Quick Chats
Quick Chats		 + Stats
+ Review task, session, Git activity, provider, GitHub, workload, and telemetry metrics.

+ Statistics overview showing tasks, time spent, Git activity, signal, telemetry, and top models

+ Statistics dashboard showing GitHub activity and workload metrics +
+ +## Automations + + + + + + + + + +
+ Workspace automations
+ Review scheduled and webhook automations, their enabled state, and recent activity.

+ Workspace automations showing scheduled and webhook triggers + 		+ Automation editor
+ Configure repository access, run destination, context, concurrency, and save changes.

+ Automation editor showing repository access, run destination, context, and save controls +
+ Automation sidebar
+ Open workspace automations from the main navigation.

+ Kandev sidebar showing workspace automations +
+ +## Plugins + +Kandev plugins and companion tools add focused views for exploring MCP servers, +monitoring service health, and tracking usage. + + + + + + + + + + + + + + + + + +
+ Plugin marketplace
+ Browse, filter, and install plugins from the in-app catalog.

+ Plugin marketplace showing available plugins and filters + 		+ Plugin settings
+ Manage installed plugins, updates, activation, and configuration.

+ Plugin settings showing installed plugins and update controls +
+ MCP Explorer
+ Inspect connected servers, available tools, and estimated token costs.

+ MCP Explorer showing an active server and available tools + 		+ GitHub Status (plugin repository)
+ See GitHub health at a glance, then open detailed component and incident status.

+ GitHub Status showing service health and an active incident

+ GitHub Status indicator in the Kandev status bar +
+ Provider Usage (plugin repository)
+ Monitor provider quota usage and reset windows from the status bar.

+ Provider Usage panel showing Codex usage and reset windows + 		+ Session Cost (plugin repository)
+ Track session spend, turns, token totals, cache reads, and per-model costs.

+ Session Cost panel showing spend, turns, token totals, and per-model costs +
+ Kandy (plugin repository)
+ Add playful progress feedback with levels, experience, status, and celebrations.

+ Kandy progress card showing level, experience, and status +
+ +## Workspace & agent settings + + + + + + + + + +
+ Integrations
+ Connect a workspace to GitHub, GitLab, Jira, Linear, Sentry, and Azure DevOps.

+ Integrations settings showing provider connection cards + 		+ Agents
+ Review detected agent CLIs, profiles, availability, and runtime updates.

+ Agents settings showing detected agent CLIs, profiles, and update indicators +
+ Executors
+ Configure local, worktree, Docker, Sprites.dev, and SSH execution profiles.

+ Executors settings showing existing and available executor profiles +
+ ## Mobile @@ -10,39 +174,81 @@
-## Desktop +## Preferences - - + - - + + - - + + - - - - - - - - - - - - - - - - - - + + +
Kanban
Kanban		Task Session
Task Session		 + Layouts
+ Configure reusable desktop workbench profiles and panel arrangements.

+ Layouts settings showing built-in desktop workbench profiles +
Pipeline
Pipeline		Plan Mode
Plan Mode		 + Language servers
+ Configure language-server startup, installation, status location, and server settings.

+ Terminal and Editors settings showing language server controls + 		+ Task Behavior
+ Configure task titles, archive confirmation, unread messages, and host sleep prevention.

+ Task Behavior settings showing task title, archive, unread message, and host sleep controls +
Workflows
Workflows		Plan Comments
Plan Comments		 + Keyboard Shortcuts
+ Customize chat input and command-panel keybindings.

+ Keyboard Shortcuts settings showing chat input and command panel bindings + 		+ Appearance
+ Configure status-bar visibility and resource metrics for the host and execution environments.

+ Appearance settings showing status bar and resource metrics controls +
CLI Agent
CLI Agent		Quick Chats
Quick Chats
File Editor
File Editor		Git Operations
Git Operations
Embedded VS Code
Embedded VS Code		Review PRs
Review PRs
Review Dialog
Review Dialog		Stats
Stats
Add Task
Add Task		Workflow Details
Workflow Details		 + Shell and terminal
+ Choose the default shell, terminal font, font size, and link behavior.

+ Terminal and Editors settings showing shell, terminal font, font size, and link controls +
+ +## System settings + + + + + + + + + + + +
+ Status
+ Check system health, the running version, and the Kandev data directory.

+ Status settings showing health, version, and disk usage + 		+ Storage
+ Review disk capacity, Kandev-managed usage, and reclaimable space.

+ Storage settings showing disk capacity and storage analysis +
+ Maintenance policy
+ Choose the schedule, idle window, workspace cleanup, and folder allowlist.

+ Maintenance policy settings showing schedule and workspace cleanup controls + 		+ Docker cleanup
+ Configure dedicated-daemon protection, build-cache retention, and unused image cleanup.

+ Docker cleanup settings showing cache and unused image cleanup controls +
+ Quarantine
+ Restore or permanently remove recoverable resources after cleanup.

+ Quarantine settings showing a recoverable resource with restore and delete controls +
diff --git a/docs/screenshots/agent-updates.png b/docs/screenshots/agent-updates.png new file mode 100644 index 0000000000..55977311ba Binary files /dev/null and b/docs/screenshots/agent-updates.png differ diff --git a/docs/screenshots/automation-editor.png b/docs/screenshots/automation-editor.png new file mode 100644 index 0000000000..e0066a4be6 Binary files /dev/null and b/docs/screenshots/automation-editor.png differ diff --git a/docs/screenshots/automation-list.png b/docs/screenshots/automation-list.png new file mode 100644 index 0000000000..3712df3512 Binary files /dev/null and b/docs/screenshots/automation-list.png differ diff --git a/docs/screenshots/automation-sidebar.png b/docs/screenshots/automation-sidebar.png new file mode 100644 index 0000000000..3ee3b4c270 Binary files /dev/null and b/docs/screenshots/automation-sidebar.png differ diff --git a/docs/screenshots/plugin-browse.png b/docs/screenshots/plugin-browse.png new file mode 100644 index 0000000000..18886ba32d Binary files /dev/null and b/docs/screenshots/plugin-browse.png differ diff --git a/docs/screenshots/plugin-github-status-bar.png b/docs/screenshots/plugin-github-status-bar.png new file mode 100644 index 0000000000..01aaa1d5e9 Binary files /dev/null and b/docs/screenshots/plugin-github-status-bar.png differ diff --git a/docs/screenshots/plugin-github-status.png b/docs/screenshots/plugin-github-status.png new file mode 100644 index 0000000000..53d1de4ce6 Binary files /dev/null and b/docs/screenshots/plugin-github-status.png differ diff --git a/docs/screenshots/plugin-kandy.png b/docs/screenshots/plugin-kandy.png new file mode 100644 index 0000000000..8b20d41a0a Binary files /dev/null and b/docs/screenshots/plugin-kandy.png differ diff --git a/docs/screenshots/plugin-mcp-explorer.png b/docs/screenshots/plugin-mcp-explorer.png new file mode 100644 index 0000000000..10a84d74fe Binary files /dev/null and b/docs/screenshots/plugin-mcp-explorer.png differ diff --git a/docs/screenshots/plugin-provider-usage.png b/docs/screenshots/plugin-provider-usage.png new file mode 100644 index 0000000000..72c848769f Binary files /dev/null and b/docs/screenshots/plugin-provider-usage.png differ diff --git a/docs/screenshots/plugin-session-cost.png b/docs/screenshots/plugin-session-cost.png new file mode 100644 index 0000000000..51361952e5 Binary files /dev/null and b/docs/screenshots/plugin-session-cost.png differ diff --git a/docs/screenshots/plugin-settings.png b/docs/screenshots/plugin-settings.png new file mode 100644 index 0000000000..a04b70b1ae Binary files /dev/null and b/docs/screenshots/plugin-settings.png differ diff --git a/docs/screenshots/pr-auto-fix.png b/docs/screenshots/pr-auto-fix.png new file mode 100644 index 0000000000..7ed66829f6 Binary files /dev/null and b/docs/screenshots/pr-auto-fix.png differ diff --git a/docs/screenshots/settings-agents.png b/docs/screenshots/settings-agents.png new file mode 100644 index 0000000000..053fe489d9 Binary files /dev/null and b/docs/screenshots/settings-agents.png differ diff --git a/docs/screenshots/settings-appearance.png b/docs/screenshots/settings-appearance.png new file mode 100644 index 0000000000..563c25b397 Binary files /dev/null and b/docs/screenshots/settings-appearance.png differ diff --git a/docs/screenshots/settings-executors.png b/docs/screenshots/settings-executors.png new file mode 100644 index 0000000000..444717f7f6 Binary files /dev/null and b/docs/screenshots/settings-executors.png differ diff --git a/docs/screenshots/settings-integrations.png b/docs/screenshots/settings-integrations.png new file mode 100644 index 0000000000..4ca14cb444 Binary files /dev/null and b/docs/screenshots/settings-integrations.png differ diff --git a/docs/screenshots/settings-keyboard-shortcuts.png b/docs/screenshots/settings-keyboard-shortcuts.png new file mode 100644 index 0000000000..c92db88e14 Binary files /dev/null and b/docs/screenshots/settings-keyboard-shortcuts.png differ diff --git a/docs/screenshots/settings-layouts.png b/docs/screenshots/settings-layouts.png new file mode 100644 index 0000000000..f755370a30 Binary files /dev/null and b/docs/screenshots/settings-layouts.png differ diff --git a/docs/screenshots/settings-task-behavior.png b/docs/screenshots/settings-task-behavior.png new file mode 100644 index 0000000000..18ad2d980a Binary files /dev/null and b/docs/screenshots/settings-task-behavior.png differ diff --git a/docs/screenshots/settings-terminal-editors.png b/docs/screenshots/settings-terminal-editors.png new file mode 100644 index 0000000000..b02fb24505 Binary files /dev/null and b/docs/screenshots/settings-terminal-editors.png differ diff --git a/docs/screenshots/settings-terminal.png b/docs/screenshots/settings-terminal.png new file mode 100644 index 0000000000..517c34bd8a Binary files /dev/null and b/docs/screenshots/settings-terminal.png differ diff --git a/docs/screenshots/stats-github-workload.png b/docs/screenshots/stats-github-workload.png new file mode 100644 index 0000000000..498966a8f3 Binary files /dev/null and b/docs/screenshots/stats-github-workload.png differ diff --git a/docs/screenshots/stats-overview.png b/docs/screenshots/stats-overview.png new file mode 100644 index 0000000000..a6e05afeec Binary files /dev/null and b/docs/screenshots/stats-overview.png differ diff --git a/docs/screenshots/stats.png b/docs/screenshots/stats.png deleted file mode 100644 index a254c97837..0000000000 Binary files a/docs/screenshots/stats.png and /dev/null differ diff --git a/docs/screenshots/system-docker-cleanup.png b/docs/screenshots/system-docker-cleanup.png new file mode 100644 index 0000000000..f188d58a1f Binary files /dev/null and b/docs/screenshots/system-docker-cleanup.png differ diff --git a/docs/screenshots/system-maintenance-policy.png b/docs/screenshots/system-maintenance-policy.png new file mode 100644 index 0000000000..c44f32df70 Binary files /dev/null and b/docs/screenshots/system-maintenance-policy.png differ diff --git a/docs/screenshots/system-quarantine.png b/docs/screenshots/system-quarantine.png new file mode 100644 index 0000000000..50bd4ba8b8 Binary files /dev/null and b/docs/screenshots/system-quarantine.png differ diff --git a/docs/screenshots/system-status.png b/docs/screenshots/system-status.png new file mode 100644 index 0000000000..b5bfcc0c36 Binary files /dev/null and b/docs/screenshots/system-status.png differ diff --git a/docs/screenshots/system-storage.png b/docs/screenshots/system-storage.png new file mode 100644 index 0000000000..93d10dee6f Binary files /dev/null and b/docs/screenshots/system-storage.png differ