diff --git a/packages/kilo-docs/pages/automate/agent-manager-workflows.md b/packages/kilo-docs/pages/automate/agent-manager-workflows.md index c24e323b005..7e4093c0598 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 8c4fa2c2332..eeb1c8a134a 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 e4d35150fe8..0d6a9fc6914 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 fb2146f314e..669794a4249 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/platforms/cloud-agent.md b/packages/kilo-docs/pages/code-with-ai/platforms/cloud-agent.md index ddbe85f3079..d465fa720f3 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** — a server-provided estimate for the session's container: an estimated hourly rate while idle, a shared interval estimate while active, and **Not currently charged** in shadow mode. Stopping and unavailable states are shown when no estimate is available. + +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. +Your work is always pushed to your repository, ensuring nothing is lost. ## Starting Tasks from the CLI 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 02d489552e8..2111a54d265 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,28 @@ 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. + +### 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. + +### 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. + ## 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 +48,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 abd5c02a1a8..b1884bf5eaf 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,30 @@ 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. +## 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). @@ -56,6 +74,8 @@ The new-session screen includes a **Run on** picker that chooses where your sess 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. +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. + ## Queueing follow-up messages The composer stays editable while the agent is working, so you don't have to wait for a session to finish before sending your next message. Type your follow-up and press **Send** to add it to the session's queue; queued messages are processed in order. While a session is streaming, **Stop** appears only when the composer is empty — with text entered, Send takes its place. diff --git a/packages/kilo-docs/pages/collaborate/enterprise/sso.md b/packages/kilo-docs/pages/collaborate/enterprise/sso.md index b52f3a8ee64..82605fd3d83 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 b78e67d9a60..663002335f6 100644 --- a/packages/kilo-docs/pages/collaborate/teams/team-management.md +++ b/packages/kilo-docs/pages/collaborate/teams/team-management.md @@ -23,6 +23,18 @@ 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 + +Instead of inviting each teammate individually, you can verify your 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. Once 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/deploy-secure/security-reviews.md b/packages/kilo-docs/pages/deploy-secure/security-reviews.md index 22c25c8fdc7..6ab4e20ec77 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/getting-started/faq/account-and-integration.md b/packages/kilo-docs/pages/getting-started/faq/account-and-integration.md index d1c2f600fab..2b358b2308d 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 070fc59df50..763b862f557 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