Kepler Documentation

Ask Kepler

Last updated: November 2026

Ask Kepler is a panel with 2 sections: a Chat with an agent that can see what’s on your screen and check on your tasks and sessions, and a Terminal of quick shells that belong to no task. Use it for a question that does not need a task of its own, or to find out what needs you without leaving the page you’re on.

For the agent sessions that run inside a task, see Agent Sessions.


The Ask Kepler panel under the top bar's highlighted Ask button, its header holding New chat with a chevron for past chats, Archive (unavailable on a new chat), the New chat button, Terminal, Dock panel and Close. Kep, the planet mascot, sits over Ask Kepler anything and the starters What needs me right now?, Find or change a setting and What changed across my tasks today?, above the Ask anything composer with the attach and microphone buttons and the Default agent pill.
Ask Kepler, open on a new chat.

Open and close the panel

You can open Ask Kepler from anywhere in Kepler in one of these ways:

How Opens
The Ask Kepler button (Kep, the planet mascot, with the word Ask) in the top bar The panel, on the section you used last
Ctrl/⌘ + K or Ctrl/⌘ + L (Toggle Ask Kepler chat) The Chat section
Ctrl + ` on every platform, macOS included (Toggle Ask Kepler terminal) The Terminal section, starting a shell if none is open
Ctrl/⌘ + Shift + K or Ctrl/⌘ + Shift + L (New Ask Kepler chat) A new chat, from anywhere in the desktop app

To close the panel, press the same shortcut again while focus is inside it. On Windows and Linux, a focused shell uses Ctrl + L to clear its screen, so press Ctrl + K to open or close the chat from inside a terminal.

On a phone, tap Kep in the Dashboard bar. The panel opens full screen, so it has no Dock panel and no controls to move it to the other side.

The top bar button shows the state of your chats. When a chat needs something from you, the button becomes a pill that reads Needs you, New reply, or Failed. Click the pill to open the panel on that chat.

Floating or docked. By default, the panel floats as a card over the left or right edge of the page, and you can still use the page behind it. To make the panel a column of the window, with the page narrowed beside it, click Dock panel in the panel’s header. Click it again to float the panel. Close Ask Kepler beside it puts the panel away.

Right-click the panel’s header, or press the keyboard’s context-menu key on it, for the panel’s menu: Dock panel, and Move to the left or Move to the right to move the panel to the other edge of the window.


The Ask Kepler panel docked on the right of the window, with the Dashboard's Tasks view narrowed beside it rather than covered. The panel's header menu is open, with Dock panel checked above Move to the left.
Ask Kepler docked beside the Dashboard, with the header’s menu open.

Resize. Drag the panel’s inner edge (Resize Ask Kepler) to change its width, or focus the edge and use the arrow keys. Double-click the edge to return to the default width. Kepler remembers the width, the side, and whether the panel is docked on this computer, for every window.

Escape also closes the panel, except in a shell, a find bar, or a text field that holds a draft. In a chat whose agent is still answering, Escape stops the turn instead.

Closing only hides the panel. A half-typed question, the open chat, and every shell’s scrollback are still there the next time you open it.


The chat

The Chat section is a conversation with an agent that works for you across Kepler rather than inside one task. Pick the agent from the pill in the composer, type your question, and send it.

You can attach files to a chat from its first message on: use Attach a file, drop files onto the composer, or paste them.

Starter prompts

A new chat offers starting points you can send with one click:

  • What needs me right now?
  • Find or change a setting. See Finding and changing settings
  • Summarize this task, only while you’re on a task’s page
  • What changed across my tasks today?

A starter goes out on its own as the chat’s first message, and it leaves your draft in the composer as it was.

What the chat knows

The chat keeps up with what you have on screen. With each message, the agent knows:

  • The page you’re on: the Dashboard, a task, Settings, or somewhere else
  • The task you’re looking at, and its worktrees and folders
  • The sessions on screen

So you can ask what’s this one stuck on? about the task in front of you. Kepler also tells the agent which sessions are waiting on you, such as approvals, permission requests, questions, and failed or unread sessions. To get that list, ask What needs me right now?

The agent can read your tasks and sessions and act on them through Kepler’s own tools. Before the agent starts a session on a task that it did not create, Kepler asks you first. When it mentions a task, a session, a task note, or a setting, it names it as a link you can click; a setting link shows the setting’s name and opens it in Settings.

It can take you there. Ask the chat to show you a task, a session, a note, a Dashboard view, or a setting, and it opens it in the window you asked from. It can also press some of Kepler’s own shortcuts for you, such as maximizing a panel or switching the Dashboard’s layout. Your cursor stays in the chat. If you are typing somewhere else or a dialog is open, it keeps your view as it is and tells you.

Ask how your agent work is going

The chat can answer questions about your own usage, from the usage insights Kepler keeps on your computer. For example, you can ask how many tokens or how much cost your agents used this week, how long agents worked or waited on you, how often you hit a usage limit, or how quickly your pull requests merged. These answers need Collect usage insights on. See Insights.

Finding and changing settings

The chat can look up Kepler’s settings for you. Ask where something is set, or what a setting is set to, and the agent finds the setting, tells you its current value and what it can be set to, and links to it. Click the link to open Settings at that setting. Only Ask Kepler can find and change settings; agents in tasks cannot.

The agent changes a setting only when you ask it to. It can find and link to some settings but not change them, such as secrets and settings that take a list.

The agent can also list your Actions and read an Action’s prompt. When you ask, it can change the prompt of an Action you created, and Kepler asks for your approval every time. To change a built-in Action, edit it in Settings → Actions.

Some changes wait for your approval: a change to a setting that affects your accounts, your privacy, other tools, what runs, or where files go. Kepler asks about each such change separately, and you approve it on its own. See Approval requests.

Kepler keeps some settings, such as the theme, the language, or the terminal font, on your own computer. When you use Kepler in a browser or a remote window, the window you asked from applies such a change and offers Undo. See Settings.

Changing your Dashboard views

Ask the chat to add a view to the Dashboard, or to rename a view or change its filters. The agent changes views only when you ask, and tells you when a filter matches nothing. See Views.

Set up an automation

Describe an automation in your own words, such as Every Monday at 9, check my repos for outdated dependencies, and the chat sets it up. You can also type the request in the New automation dialog in Automations and click Ask Kepler, which sends it to a new chat.

The chat creates the automation paused and shows an Automation created card with what the automation watches, what it runs, and where. To start it, click Turn on. To see it in Automations, click Open. See Automations.


The Automation created card in an Ask Kepler chat for Check dependencies every Monday: Schedule, Weekly on Monday, 9:00 AM, UTC, the start of its prompt with Show full prompt, On your default agent, In /home/alex/kepler/repositories, and Paused until you turn it on, with the Turn on and Open buttons.
An automation that Ask Kepler set up, paused until you turn it on.

Which agents can answer

The agent pill lists only agents that run in Chat. An agent that runs only in a terminal, such as Pi, cannot answer in the panel. See Agent Integrations for which agents run in Chat.

Ask Kepler keeps its own agent, separate from tasks. A new chat opens on the agent you picked last in the panel, and picking an agent here never changes a task’s agent, or the reverse. Your first chat uses the agent and settings set in Settings → Agents under New Ask Kepler chats start with. To start every chat there instead of on your last pick, clear Start each chat on the agent you used last. See Settings: Agents.

Past chats and new chats

To switch chats, open the chat’s title in the panel header. To find a chat, type in Search chats at the top. The search also finds archived chats, and picking one restores it. The picker lists:

  • New chat, which returns the section to a fresh chat
  • Continue in a new task, for the chat that’s open
  • Your open chats, grouped by state, such as Unread and Running. Click one to open it, or click Archive beside it to put it away.
  • Show archived, which lists your archived chats. Click one to restore and open it.

Ask Kepler's chat picker open: a Search chats field at the top, then New chat, Unread (Summarize the merged P…, blue dot), Needs attention (Run the checkout tests, orange dot), Running (Watch CI on PR 51, green dot) and Recent (Which tasks are blocked on…, gray dot), each with the agent's icon, now and an Archive button. Hide archived (1) is open below them, listing Which worktrees can I clean u… with a Restore button.
The chat picker, with the archived chats shown.

The New chat button beside the title starts a new chat. The Archive button before it archives the chat that’s open.

Continue in a new task

When an answer turns out to be the start of real work, choose Continue in a new task, under the chat’s latest reply or in the chat picker. It opens the New task composer with a prompt to pick up where the chat left off, the chat attached as the session the task continues from, and the same agent, account, model, and mode the chat used. Edit anything you like before you start the task. See Create a task.

A panel chat belongs to no task, so when a task’s session links back to the chat it continued from, the chat opens in the panel. A notification from a panel chat also opens the panel on that chat.


Quick terminals


The Ask Kepler panel, open on its Terminal section, under the top bar's highlighted Ask button: the header strip holds Chat, the Terminal 1 tab with its menu and trash buttons, and New terminal, then Dock panel and Close. The shell runs in the home folder and shows a git log of acme-web's last three commits.
The Terminal section, with one shell in the home folder.

The Terminal section holds shells that belong to no task, in the same tab strip a task page’s terminal drawer uses. The first time you open the section, Kepler starts a shell. After you close the last shell, the strip stays empty until you click New terminal or press Ctrl + `.

Where a new shell opens depends on where you are:

  • On a task’s page, a new shell opens in one of that task’s worktrees or folders.
  • Anywhere else, or on a task with no worktrees or folders, it opens in your Home folder.

The panel’s shells belong to the panel. They never move to a task’s terminal drawer, and they keep running when you move between pages or close the panel. To go back to the chat, click Chat at the start of the tab strip.


Have feedback about this article? Did we miss something? Let us know!
On this page