diff --git a/packages/kilo-docs/pages/automate/agent-manager-workflows.md b/packages/kilo-docs/pages/automate/agent-manager-workflows.md index c24e323b0053..7e4093c05988 100644 --- a/packages/kilo-docs/pages/automate/agent-manager-workflows.md +++ b/packages/kilo-docs/pages/automate/agent-manager-workflows.md @@ -155,6 +155,7 @@ Layer review in before asking a teammate: - **`/review`** — slash command, AI review of staged, unstaged, and untracked changes in the worktree when run without arguments. Good as a last pass before committing. - **`/review uncommitted [guidance]`** — explicitly review uncommitted changes, optionally focusing the review with guidance. - **`/review branch [base] [guidance]`** — review the whole branch vs. its detected or specified base, with optional guidance. +- **`/review worktree [guidance]`** — review every committed, staged, unstaged, and untracked change in the worktree against its recorded parent branch. This scope is offered only in Agent Manager worktree sessions. - **`/review ` or `/review `** — review a specific commit or pull request. - **`kilo review` in CI** — automated PR review. See [Code Reviews](/docs/automate/code-reviews/overview) for the setup. - **Human review** — push the branch from the session terminal and `gh pr create`. The PR badge appears on the worktree and stays in sync with CI and reviews. diff --git a/packages/kilo-docs/pages/automate/agent-manager.md b/packages/kilo-docs/pages/automate/agent-manager.md index 8c4fa2c23324..eeb1c8a134a1 100644 --- a/packages/kilo-docs/pages/automate/agent-manager.md +++ b/packages/kilo-docs/pages/automate/agent-manager.md @@ -189,7 +189,8 @@ Imported work stays associated with its branch or worktree and can be continued - Create a worktree session to start a new agent in an isolated branch - Press `Cmd+T` (macOS) / `Ctrl+T` (Windows/Linux) to start another session in the selected worktree -- Use session history to reopen local sessions or preview cloud sessions +- Use session history to reopen local sessions or preview cloud sessions. Open it with the history button in the **WORKTREES** header; in multi-project mode, each project row has its own history button, including collapsed projects. Opening a project's button activates that project and filters the Local history tab to that project's sessions. +- Hover a session in the history list for direct actions: open the session in a newly created worktree, or move it to the project root and open it in the project's local tabs. - When a worktree is selected, open session history to use the **Worktree** source, which is selected by default and lists only sessions assigned to that worktree. Opening a worktree session returns to its owning worktree. - Continue a cloud session locally from Agent Manager using the same extension sign-in and provider settings @@ -218,9 +219,11 @@ Each request can include 1-20 tasks. Each task must include at least one of `pro The companion `agent_manager_models` tool searches models and their supported reasoning variants on demand. Results are grouped by model name (with the offering providers listed for reference) and limited to 20 per call, so the full catalog is never added to the conversation context. -The same tool also manages existing sessions. It can return an overview of sections, worktrees, and local sessions, send a prompt to one managed session, stop a managed session, or move a session's worktree into a section. The overview includes section IDs, each section's assigned worktrees, worktree IDs, and session IDs. Use those exact IDs for a subsequent move. Moving accepts a section ID from the overview, or `null` to ungroup the worktree. Moving a session moves its whole worktree, including multi-version siblings. Local sessions cannot be assigned to a section. Stopping aborts the session's active work and removes it from the panel, just like closing the session tab. +The same tool also manages existing sessions. It can return an overview of sections, worktrees, and local sessions, send a prompt to one managed session, stop a managed session, move a session's worktree into a section, or answer a managed session's pending question. The overview includes section IDs, each section's assigned worktrees, worktree IDs, and session IDs. Use those exact IDs for a subsequent move. Moving accepts a section ID from the overview, or `null` to ungroup the worktree. Moving a session moves its whole worktree, including multi-version siblings. Local sessions cannot be assigned to a section. Stopping aborts the session's active work and removes it from the panel, just like closing the session tab. -The tool uses the `agent_manager` permission. Approval prompts are scoped to the requested capability, so approving `worktree` does not automatically approve `local`, an overview, or a targeted prompt. Prompting an existing managed session requires an explicit `prompt` approval the first time, even if Agent Manager session creation was previously approved broadly. Stopping a session likewise requires an explicit `stop` approval, and moving a worktree requires an explicit `move` approval. +A session waiting on a question refuses prompts. The failed prompt names the session ID, the pending question's ID and text, and its option labels, so a follow-up `answer` call can resolve the question with the exact labels shown. Answering resolves questions only — a session blocked on a permission request must be approved in the Agent Manager UI instead. + +The tool uses the `agent_manager` permission. Approval prompts are scoped to the requested capability, so approving `worktree` does not automatically approve `local`, an overview, or a targeted prompt. Prompting an existing managed session requires an explicit `prompt` approval the first time, even if Agent Manager session creation was previously approved broadly. Stopping a session likewise requires an explicit `stop` approval, moving a worktree requires an explicit `move` approval, and answering a pending question requires an explicit `answer` approval. ## Sections diff --git a/packages/kilo-docs/pages/automate/code-reviews/overview.md b/packages/kilo-docs/pages/automate/code-reviews/overview.md index e4d35150fe8e..0d6a9fc69144 100644 --- a/packages/kilo-docs/pages/automate/code-reviews/overview.md +++ b/packages/kilo-docs/pages/automate/code-reviews/overview.md @@ -124,6 +124,7 @@ Use `/review` for all local code reviews: - **`/review`** — Review uncommitted changes (staged, unstaged, and untracked) when run without arguments - **`/review uncommitted [guidance]`** — Review uncommitted changes with optional guidance - **`/review branch [base] [guidance]`** — Review your current branch vs. its detected or specified base, with optional guidance +- **`/review worktree [guidance]`** — Review every committed, staged, unstaged, and untracked change in an Agent Manager worktree against its recorded parent branch (offered only in Agent Manager worktree sessions) - **`/review `** — Review a specific commit - **`/review `** — Review a pull request diff --git a/packages/kilo-docs/pages/automate/integrations.md b/packages/kilo-docs/pages/automate/integrations.md index fb2146f314ef..669794a4249c 100644 --- a/packages/kilo-docs/pages/automate/integrations.md +++ b/packages/kilo-docs/pages/automate/integrations.md @@ -40,6 +40,10 @@ Before connecting: Go to your **Personal** or **Organization Dashboard**, and navigate to the [Integrations](https://app.kilo.ai/integrations) tab. +{% callout type="note" %} +For organizations, only Owners and Admins can add a GitHub integration. If you have another role, ask an Owner or Admin to complete the installation. +{% /callout %} + ### 2. Start the Connection Flow 1. Click **Configure** on the GitHub panel. @@ -163,7 +167,7 @@ Once your integrations are connected, the following features are enabled in Kilo ### Upcoming: -- **Bitbucket Integration** +- **Bitbucket Integration** — currently available only for organizations when starting [Cloud Agent](/docs/code-with-ai/platforms/cloud-agent) sessions; full integration support is upcoming --- @@ -171,6 +175,10 @@ Once your integrations are connected, the following features are enabled in Kilo ### GitHub +For organizations, the GitHub integration page lists each installation with its connection health, repository scope (all or only selected repositories), the selected repositories, and per-installation actions. Personal accounts keep the single GitHub identity connection. + +An organization can connect more than one GitHub organization. Click **Add organization** on the GitHub panel and repeat the installation flow for each GitHub organization; each one appears as a separate installation with its own repository scope and actions. Adding installations requires the Owner or Admin role. + From the **Integrations** page, click "Manage on GitHub" to: - View the GitHub account you connected diff --git a/packages/kilo-docs/pages/code-with-ai/agents/context-mentions.md b/packages/kilo-docs/pages/code-with-ai/agents/context-mentions.md index 2a88ed2de4cf..00f5ead2fae1 100644 --- a/packages/kilo-docs/pages/code-with-ai/agents/context-mentions.md +++ b/packages/kilo-docs/pages/code-with-ai/agents/context-mentions.md @@ -26,6 +26,7 @@ Type `@` in the chat input to get autocomplete suggestions. You can mention: | **Terminal** | In the sidebar, include the active VS Code terminal output. In Agent Manager, include the focused terminal for the selected session or worktree, including embedded **Run** and **Setup** tabs. | `@terminal` | | **Git Changes** | Attach uncommitted working-tree diffs and new files | `@git-changes` | | **Past chats** | Add a previous session's chat history as context | `@` → **Past chats** → pick a session | +| **Worktrees** | In Agent Manager, reference another worktree — inserts its path with its branch, base branch, and session IDs as context | `@` → **Worktrees** → pick a worktree | Selecting a suggestion inserts the mention and highlights it in the input. File contents, terminal output, and git changes are attached as context when you send the message. @@ -37,6 +38,12 @@ Choosing **Past chats** from the `@` menu opens a searchable picker of sessions Very long chat histories are truncated, keeping the beginning and end, so a single mention cannot fill the context window. +### Referencing Agent Manager worktrees + +In Agent Manager, choosing **Worktrees** from the `@` menu opens a searchable picker of the project's worktrees. Search matches worktree names, branches, and session titles. Recently opened worktrees sort first, then worktrees with the most recent activity. + +Selecting a worktree inserts an `@` mention of its absolute path and attaches a small text record with the worktree's branch, base branch, and session IDs and titles. The mention is metadata only — it does not attach the worktree's files, diffs, or chat history, and it does not change the agent's working directory. The worktree you are currently working in is not offered as a reference. + ### Drag and Drop You can also add file mentions by dragging and dropping: diff --git a/packages/kilo-docs/pages/code-with-ai/platforms/cli.md b/packages/kilo-docs/pages/code-with-ai/platforms/cli.md index c8d0beb219d8..a9308f43c3e1 100644 --- a/packages/kilo-docs/pages/code-with-ai/platforms/cli.md +++ b/packages/kilo-docs/pages/code-with-ai/platforms/cli.md @@ -670,6 +670,11 @@ Add to `~/.config/kilo/config.json`: Once enabled, start a CLI session and open [Cloud Agents](https://app.kilo.ai/cloud). Your local session appears in the dashboard. See [Cloud Agent Remote Connections](/docs/code-with-ai/platforms/cloud-agent#remote-connections) for details. +A connected client can also start new sessions on your CLI. When it does, it can: + +- **Choose a child folder** of the CLI's launch directory as the session workspace. The CLI resolves the requested folder under the launch directory and rejects absolute paths and paths that escape it. +- **Continue one of your existing cloud sessions locally.** The CLI downloads the cloud session and opens it instead of starting a new empty session. + ### Requirements - Connection to Kilo Gateway diff --git a/packages/kilo-docs/pages/code-with-ai/platforms/cloud-agent.md b/packages/kilo-docs/pages/code-with-ai/platforms/cloud-agent.md index ddbe85f30798..24d09380f911 100644 --- a/packages/kilo-docs/pages/code-with-ai/platforms/cloud-agent.md +++ b/packages/kilo-docs/pages/code-with-ai/platforms/cloud-agent.md @@ -5,7 +5,7 @@ description: "Using Kilo Code in the browser" # {% $markdoc.frontmatter.title %} -Cloud Agents let you run Kilo Code in the cloud from any device, without relying on your local machine. They provide a remote development environment that can read and modify your GitHub and GitLab repositories, run commands, and auto-commit changes as work progresses. +Cloud Agents let you run Kilo Code in the cloud from any device, without relying on your local machine. They provide a remote development environment that can read and modify your GitHub, GitLab, or Bitbucket repositories, run commands, and auto-commit changes as work progresses. Bitbucket repositories are available for organizations only, not personal accounts. ## What Cloud Agents Enable @@ -18,8 +18,8 @@ Cloud Agents let you run Kilo Code in the cloud from any device, without relying Before using Cloud Agents: -- **GitHub or GitLab Integration must be configured** - Connect your account via the [Integrations tab](https://app.kilo.ai/integrations) so that Cloud Agents can access your repositories. +- **A GitHub, GitLab, or Bitbucket integration must be configured** + Connect your account via the [Integrations tab](https://app.kilo.ai/integrations) so that Cloud Agents can access your repositories. Bitbucket is available for organizations only. ## Cost @@ -35,14 +35,23 @@ Usage is measured in whole seconds, with no rounding up to a longer billing inte See [Kilo Code pricing](https://kilo.ai/pricing) for current rates and pricing for other cloud products. +### Session cost display + +The session header shows two separate entries: + +- **Token Usage** — the session's inference spend (model usage), paid in Kilo credits. +- **Compute** — the estimated cost of the cloud environment, which may be shared with other sessions. The display shows an hourly rate while idle or an estimate for the active period. **Not currently charged** means compute charges are not being applied. + +If a compute billing check fails — for example, when the paying account has insufficient credits — the error appears next to the composer with recovery actions appropriate to the paying account (personal or organization) and your role in it. Your prompt text is preserved so you can retry after resolving the billing issue. + ## How to Use -1. **Connect your GitHub or GitLab account** in the [Integrations](https://app.kilo.ai/integrations) tab of your personal or organization dashboard. -2. **Select a repository** to use as your workspace. +1. **Connect your GitHub, GitLab, or Bitbucket account** in the [Integrations](https://app.kilo.ai/integrations) tab of your personal or organization dashboard. Bitbucket is available for organizations only. +2. **Select a repository** to use as your workspace. The repository picker groups your repositories into Recently used and per-provider sections. 3. **Add environment variables** (secrets supported) and set optional startup commands. 4. **Start chatting with Kilo Code.** -Your work is always pushed to GitHub, ensuring nothing is lost. +Automatic commit and push depends on your session settings. If it is disabled, review, commit, and push the changes you want to keep. ## Starting Tasks from the CLI @@ -185,6 +194,8 @@ When creating a trigger, you choose an **activation mode** that cannot be change Triggers utilize [agent environment profiles](#agent-environment-profiles) to configure the execution environment for triggered sessions. The agent resolves the profile at runtime, so profile updates apply automatically to future executions. Profiles referenced by triggers cannot be deleted until those triggers are updated or removed. +Both webhook and scheduled triggers can optionally set a **reasoning effort** for models that support it. The effort picker sits next to the model selector and starts at **Default**, which leaves the model's own behavior unchanged. Choosing a specific effort stores it on the trigger and applies it to every session the trigger starts; existing triggers keep working without one. + Triggers do not support manual env var or setup command overrides at this time. ### Scheduled Triggers diff --git a/packages/kilo-docs/pages/code-with-ai/platforms/jetbrains.md b/packages/kilo-docs/pages/code-with-ai/platforms/jetbrains.md index 02d489552e82..d57b2b038697 100644 --- a/packages/kilo-docs/pages/code-with-ai/platforms/jetbrains.md +++ b/packages/kilo-docs/pages/code-with-ai/platforms/jetbrains.md @@ -17,6 +17,41 @@ Open **Settings → Tools → Kilo Code** to configure the plugin. The JetBrains - **Context** — toggle auto-compaction, set the auto-compaction limit (the percentage of the model window that triggers compaction), enable pruning of old tool outputs, and manage file watcher ignore patterns. See [Context Condensing](/docs/customize/context/context-condensing) and [.kilocodeignore](/docs/customize/context/kilocodeignore) for what these settings control. - **Agent Behavior → Skills** — inspect loaded skills, add extra skill sources (local paths or remote URLs), edit or remove custom skills, and open skill files in the editor. See [Skills](/docs/customize/skills) for the skill format and discovery rules. +## Chat and Agents tabs + +The Kilo Code tool window is split into two tabs: + +- **Chat** — the conversation with the agent in the current workspace. +- **Agents** — the Agent Manager, a control panel for running and orchestrating multiple agents in parallel, each in its own git worktree. A notification dot appears on the tab when a worktree session needs attention. + +The tool window toolbar has labeled create actions: **+ Session** starts a new session in the Chat tab, and **+ Worktree** opens the New Worktree dialog in the Agents tab. + +When a chat has no session yet, the empty state reflects where you are working. On a plain branch it suggests keeping changes isolated and offers a **run it in a worktree** link that opens the New Worktree flow; in a worktree it confirms that your main checkout stays untouched. + +### Working with worktrees + +- The worktree list shows each session's activity state with compact status icons and badges, including a running indicator for active sessions. +- Drag worktrees to reorder them; the order is persisted and selection stays stable across refreshes. +- Session history is scoped to the current worktree, so sessions from the main checkout or sibling worktrees are not mixed in. Sessions started from a worktree's separate IDE frame also appear in Agent Manager. +- In a worktree editor tab, the session-list toggle hides or shows the session list. The choice is remembered per worktree. While the list is hidden, the toggle shows the session count or flags a background session that needs your attention, so a pending question stays visible. + +### Chat branch dock + +When the workspace is a git repository, the chat header shows a branch dock with the current branch, a file-change summary, and worktree actions: + +- **New Worktree** — open the New Worktree dialog, which has three tabs: **New** creates a worktree on a new branch with an optional initial prompt, **From PR** imports a GitHub pull request by URL, and **From Branch** imports an existing local branch that no worktree is using yet. Imported PR branches get git tracking set up, so `git push` and `git pull` work in the new worktree. +- **Move to Worktree** — move the conversation and your current local changes into a dedicated worktree for isolated follow-up work. Available whenever the repository has local changes, even before the chat has a session. + +When the branch has an associated pull request, the dock shows the PR badge and title with access to the diff. Worktree actions appear only while the session is idle. + +## Mermaid diagrams in chat + +Chat renders `mermaid` and `mmd` code fences as inline diagrams. While a reply is still streaming, or if a diagram fails to render, the fence shows its source instead. + +- **Viewer window** — click a rendered diagram to open it in a resizable viewer with zoom controls, trackpad pinch zoom, Cmd/Ctrl+wheel zoom, drag to pan, and double-click to fit. +- **Editor tab** — use the open action on a diagram's toolbar to open it in its own editor tab with a rendered **Diagram** view and a read-only **Source** view. +- **Copy** — copying a rendered diagram puts the picture (PNG) on the clipboard. While streaming or after a render error, copy falls back to the Mermaid source. + ## Reviewing session changes - **Modified files per turn** — each assistant turn that changed files shows a **Modified** card with the affected files and their diff stats. Expand a file to see its diff inline, or open all of the turn's changes in the **Changed files** diff viewer. @@ -26,3 +61,9 @@ Open **Settings → Tools → Kilo Code** to configure the plugin. The JetBrains ## Permission requests When the agent asks for several approvals at once, permission requests queue up instead of replacing each other. Resolve the current request to advance to the next one in the queue. + +## Turn failures and retries + +When a turn fails — for example from a provider error or missing provider credentials — the transcript ends with an error card showing the failure details and a **Retry** action. Retry replays the failed turn using the model and agent selected at that moment, so you can switch away from an unavailable provider and press **Retry** to continue the conversation. + +Pressing **Stop** is not treated as a failure. The transcript shows a short "Stopped" note, and the session does not get an error badge in the history, recents, or Agent Manager worktree rows. diff --git a/packages/kilo-docs/pages/code-with-ai/platforms/mobile.md b/packages/kilo-docs/pages/code-with-ai/platforms/mobile.md index abd5c02a1a87..eb24fe7ab4bb 100644 --- a/packages/kilo-docs/pages/code-with-ai/platforms/mobile.md +++ b/packages/kilo-docs/pages/code-with-ai/platforms/mobile.md @@ -25,12 +25,34 @@ The mobile app lets you: - Review GitHub pull requests end to end — diffs, checks, comments, and merging. - Start a new session on a connected `kilo remote` CLI instance with the **Run on** picker. +## Agents tab and session history + +The **Agents** tab lists only your running sessions. Tap **See all** on the Agents tab to open the history page, which lists past sessions with search, platform and project filters, and sorting, and loads more history as you scroll. A session that finishes while you are away appears in history the next time you open or return to the history page — no manual refresh needed. On the Home screen, **See all** opens the running-sessions list instead of the history page. + +## Language and region + +The app renders in 87 languages. It follows your device language by default and falls back to English when the device language is not supported. + +To override the device language, use the language picker on the login screen or in **Preferences**. The picker supports search and shows each language in its own script. Dates, times, and currency formatting follow the active language. + +Choosing a language with a different layout direction (such as Arabic or Hebrew) restarts the app into a mirrored, right-to-left layout; a same-direction change applies in place. A restart keeps the email you typed on the login screen. + +Push notifications arrive in the language the device had when it registered, so each device gets its own language. + ## Privacy and telemetry On first launch, the app asks for your consent before enabling optional telemetry — product analytics, attribution, and performance tracing. Optional telemetry is pre-selected during onboarding; you can turn it off before accepting. No optional analytics starts before you make a choice. You can review or change your decision at any time in **Settings**. Declining optional telemetry keeps you signed in, and optional telemetry state stored on the device is stopped and discarded when you revoke consent or sign out. +## Links and images in chat + +Model replies can contain links and images, and the app asks before anything loads or opens: + +- **Images stay hidden until you tap Load.** Each image shows its host and a **Load** button, and nothing is fetched until you tap it. Only HTTPS images can load — `http` and `data:` images show a static "HTTPS images only" chip instead. +- **Links confirm their destination host** in a native alert before they open in the browser. Choose **Trust this host** to open that host's links directly from then on. +- **Preferences → Trusted hosts** lists every host you have trusted, and you can revoke any of them. Trusted hosts are cleared when you sign out. + ## Kilo Pass and Billing For Kilo Pass pricing, billing, and account management details, use the [Kilo Pass pricing page](https://kilo.ai/pricing/kilo-pass). @@ -54,7 +76,20 @@ The new-session screen includes a **Run on** picker that chooses where your sess - **Cloud Agent** — the managed cloud environment (the default). - **A connected CLI instance** — a `kilo remote` CLI running on your own machine. The picker lists the instances currently connected to your account. -Remote sessions start with the mode and model selected on the new-session screen; older CLI versions that don't accept those fields fall back to their own defaults. The workspace is always the CLI's own checkout, so there is no repository selection — you type your first prompt in the chat after the session starts. The picker also appears in organization context, where the spawned session is attributed to the organization. +Remote sessions start with the mode and model selected on the new-session screen; older CLI versions that don't accept those fields fall back to their own defaults. By default, the workspace is the CLI's launch directory. The picker also appears in organization context, where the spawned session is attributed to the organization. + +When you start a session on a connected CLI instance, a **Folder** field lets you pick a child folder of the instance's launch directory as the session workspace. You can drill down any number of levels, and **Start** opens the session in the chosen folder. A connected instance running an older CLI version that cannot list folders shows a message instead, and **Start** opens the session in the instance's launch folder. + +For Cloud Agent sessions, you pick the repository the agent works on. The repository picker groups your repositories into **Recently used** and per-provider sections — GitHub, GitLab, and, for organizations, Bitbucket — and shows each repository's provider next to its name. Each provider shows its own connect prompt or error message, so a problem with one provider does not hide the repositories of another. + +## Continuing a finished session + +Open a finished session and tap **Continue** to carry the conversation into a new session. The Continue form starts pre-filled from the source session — repository, agent mode, model, and variant — and you pick where the new session runs: + +- **Cloud Agent** — copies the source conversation into a new Cloud Agent session and opens it once it is ready. +- **A connected CLI instance** — imports the source conversation into the CLI. A CLI that cannot import sessions is refused before anything runs, with the reason shown and **Start** disabled. + +**Start** also stays disabled when the selected model or repository is no longer available. ## Queueing follow-up messages diff --git a/packages/kilo-docs/pages/collaborate/enterprise/sso.md b/packages/kilo-docs/pages/collaborate/enterprise/sso.md index b52f3a8ee643..82605fd3d83d 100644 --- a/packages/kilo-docs/pages/collaborate/enterprise/sso.md +++ b/packages/kilo-docs/pages/collaborate/enterprise/sso.md @@ -54,6 +54,10 @@ Copy the Service Provider details (Entity ID, ACS URL, and Metadata) from the Wo 1. Set the organization policy and user provisioning settings according to your organization's needs. 2. Configure domain policy and domain verification in WorkOS. +{% callout type="info" %} +WorkOS domain verification for SSO is separate from [verified-domain auto-join](/docs/collaborate/teams/team-management#joining-automatically-with-a-verified-domain), which automatically adds users with a matching email domain to your organization and does not require SSO. +{% /callout %} + After enabling SSO: - Invite new users with their company email domain. diff --git a/packages/kilo-docs/pages/collaborate/teams/team-management.md b/packages/kilo-docs/pages/collaborate/teams/team-management.md index b78e67d9a60a..3b97cb220b89 100644 --- a/packages/kilo-docs/pages/collaborate/teams/team-management.md +++ b/packages/kilo-docs/pages/collaborate/teams/team-management.md @@ -23,6 +23,20 @@ Members can use the Kilo Code extension and see data on the team's usage in the {% image src="/docs/img/team-management/invite-member.png" alt="invite-member" width="619" caption="invite-member" /%} +## Joining automatically with a verified domain + +An organization Owner or Admin can verify the organization's email domain so matching users join automatically: + +1. **Navigate to your Organization dashboard** and open the **Verified Domains** card +2. **Add your company's email domain** and complete the verification steps to prove ownership +3. Return to **Verified Domains** and click **Check status** to confirm the domain shows **Verified** + +Once the domain is verified, anyone who signs in to Kilo with a matching email address is added to the organization as a Member automatically. + +Auto-join applies to browser sign-in, SSO sign-in, and the mobile app's native sign-in. It adds users as ordinary Members only — Owner roles still require an explicit role change. Users keep their personal account and any unrelated organization memberships, and a member who is removed from the organization is not re-added automatically. + +Verified domains work independently of SSO — you don't need SSO configured to use them. For SSO setup, see [SSO](/docs/collaborate/enterprise/sso). + ## Removing Team Members When team members leave: diff --git a/packages/kilo-docs/pages/customize/context/context-condensing.md b/packages/kilo-docs/pages/customize/context/context-condensing.md index 9339ed5509f7..d0a3cec5033c 100644 --- a/packages/kilo-docs/pages/customize/context/context-condensing.md +++ b/packages/kilo-docs/pages/customize/context/context-condensing.md @@ -109,6 +109,8 @@ Summarization can use a cheaper or larger-context model than your main agent. Co If no compaction agent is set, the current session's model is used. +You can also pick the compaction model without editing config: open **Settings → Models** and use the compaction model selector. It applies to both automatic and manual compaction, and does not change your chat model. Clear the selection to go back to using the chat model. + ### Environment overrides | Variable | Effect | diff --git a/packages/kilo-docs/pages/deploy-secure/security-reviews.md b/packages/kilo-docs/pages/deploy-secure/security-reviews.md index 22c25c8fdc79..6ab4e20ec779 100644 --- a/packages/kilo-docs/pages/deploy-secure/security-reviews.md +++ b/packages/kilo-docs/pages/deploy-secure/security-reviews.md @@ -375,9 +375,11 @@ SLA notifications require both SLA tracking and SLA notifications to be enabled. ## Notification delivery -Security Agent currently sends notifications only by email. +Security Agent sends notifications by email and by push to the mobile app. -Notification kinds: +Push notifications are sent when an analysis completes or fails, and when a remediation is queued, opens a pull request, fails, is blocked, needs no changes, or is cancelled. For a personal Security Agent, pushes go to the owning user. For an organization Security Agent, they go to the organization owners. + +Email notification kinds: | Kind | When eligible | |---|---| @@ -408,6 +410,8 @@ The audit report shows Security Finding activity recorded for an owner during a - `/security-agent/audit-report` - `/organizations/:organizationId/security-agent/audit-report` +The audit report is also available as a native screen in the mobile app, showing the report period and each finding's recorded activity. + The audit report is based on activity recorded by Kilo. It does not prove that every historical event is present, show repository scan coverage, or provide aggregate SLA compliance. ### Report period and filters @@ -480,7 +484,7 @@ The following capabilities are not yet implemented but are being considered for - GitLab support for Security Agent findings and remediation. - Security Finding sources beyond Dependabot alerts, such as npm audit and SBOM analysis. -- Notification channels beyond email. +- Notification channels beyond email and mobile push. - Historical replay when you enable New-finding Notifications. - Analysis and remediation without queue delays. This work currently runs through queues and can be delayed by account capacity or worker backlog. - Automatic finding updates based on the full remediation PR lifecycle. A finding currently closes only when Dependabot reports it fixed or someone dismisses it. diff --git a/packages/kilo-docs/pages/gateway/models-and-providers.md b/packages/kilo-docs/pages/gateway/models-and-providers.md index e7bcaced7ab1..0e15d994a6de 100644 --- a/packages/kilo-docs/pages/gateway/models-and-providers.md +++ b/packages/kilo-docs/pages/gateway/models-and-providers.md @@ -56,7 +56,7 @@ This returns model information including pricing, context window, and supported ### Free models -Several models are available at no cost, subject to rate limits: +Several models are available at no cost, subject to rate limits. Availability changes; check the [live model catalog](https://kilo.ai/models) for current free options. | Model ID | Description | |---|---| diff --git a/packages/kilo-docs/pages/getting-started/faq/account-and-integration.md b/packages/kilo-docs/pages/getting-started/faq/account-and-integration.md index d1c2f600fab2..2b358b2308d4 100644 --- a/packages/kilo-docs/pages/getting-started/faq/account-and-integration.md +++ b/packages/kilo-docs/pages/getting-started/faq/account-and-integration.md @@ -18,6 +18,20 @@ Your organization will become inaccessible. No charges will be applied. If you have any remaining credits in your organization, you can contact Support to request that they be moved to your personal account. +### How do I delete my account? + +You can delete your personal account yourself from the [profile page](https://app.kilo.ai/profile): + +1. Open the **Danger Zone** card on your profile +2. Start the deletion flow and confirm by entering your email address +3. You are signed out once the deletion starts + +Account deletion is permanent. Cancel any active subscriptions before starting. When the deletion completes, you receive a confirmation email. + +{% callout type="note" %} +Accounts managed by an organization cannot be deleted self-service — the Danger Zone is hidden for them. Contact your organization admin or Kilo support instead. +{% /callout %} + ## Integrations ### How do I unlink my GitHub account? diff --git a/packages/kilo-docs/pages/getting-started/settings/auto-approving-actions.md b/packages/kilo-docs/pages/getting-started/settings/auto-approving-actions.md index 070fc59df500..763b862f5573 100644 --- a/packages/kilo-docs/pages/getting-started/settings/auto-approving-actions.md +++ b/packages/kilo-docs/pages/getting-started/settings/auto-approving-actions.md @@ -70,7 +70,7 @@ Use the shield button in the prompt controls to toggle runtime auto-approve for Expand **Manage Auto-Approve Rules** to add commands or patterns to your allowed or denied lists. These rules are then appended to the bottom of the approval rules in settings and the config file. -For the `agent_manager` tool, runtime approvals use the requested capability as the pattern: `worktree`, `local`, `overview`, or `prompt`. Prompting an existing managed session always requires an explicit `prompt` approval the first time, even when a broad Agent Manager allow rule already exists. +For the `agent_manager` tool, runtime approvals use the requested capability as the pattern: `worktree`, `local`, `overview`, `prompt`, `stop`, `move`, or `answer`. Prompting an existing managed session always requires an explicit `prompt` approval the first time, even when a broad Agent Manager allow rule already exists. The same applies to stopping a session, moving a worktree, and answering a managed session's pending question — each requires its own explicit approval. ## MCP Tool Permissions