AI agent
Agent chat basics
Open a workspace-scoped chat, attach only the context you need, choose a model, and review the streamed work and the files it changed.
Updated
By Kition Docs
Verified against Kition 0.2.0 (7d49036f) on 2026-11-06
Before the first message
The Agent needs a usable text model. By default Kition uses Kition Cloud: sign in with your Kition Account and hosted models are used with your Kition credits. To use your own key instead, connect and sync a provider in Settings → AI Providers.
Until a model is available, the Agent panel offers Configure a model or Sign in to use Kition Cloud instead of running the task. The active provider and model are device-wide settings; you can change them from the model picker in the Agent composer.
Open and manage chats
Agent sessions and their event logs are mirrored under the workspace’s .kition/agents/ folder. They can contain prompts, document content, tool arguments, and generated output, so treat workspace backups and shared copies as sensitive.
The chat tabs and history do not offer permanent session deletion. Closing a tab does not erase its saved history.
- Use Open AI Chat to open the right-side Agent panel; Collapse AI Chat hides it again
- Choose New chat for a separate session
- Use View history to search and reopen this workspace’s chats
- Close a chat tab to hide it from the tab strip; reopen the session from Agent history
- Use Add to chat or Add to new chat on an item in the workspace tree to reference it in a chat
Attach context deliberately
- The open document, workflow, or media gallery shapes the context sent with the turn
- Type
@to search every workspace document and reference one in the message - Use Add context to attach the current document, another workspace document, or a local folder
- Local folders are read-only analysis sources and are limited to eight per session
- Dropped or pasted files can be attached when the current pane supports it
Heads up
Attached documents and local-folder contents may be sent to the selected model provider for the active task. Review the Context tray before sending sensitive work.
Send, add a newline, or stop
- Enter sends the message when the mention menu is closed
- Shift + Enter inserts a newline
- The send button becomes Stop while the current chat is running
- Stop ends the turn; it does not roll back tool actions that already completed, and a tool that was already running may still finish in the background
Live or Draft edits to kit files
The Kit edits switch in the composer chooses how the Agent changes files opened by kits. Live (the default) edits the open document directly; you see the changes and can undo them. Draft edits a draft of the document instead and leaves the document itself untouched.
With a draft, a banner above the document says the Agent is editing a draft or that its draft is ready for review. Choose Review to compare Document now with With the draft merged, including added, changed, and removed objects and text changes, then Merge or Discard. Undo takes a merge back in one step. Draft editing is available for kits that support drafts; other kits are edited live.
Review the run
The timeline shows tool calls with their inputs, outputs, and errors, plan updates, saved results, reconnect attempts, and shell approval requests. Files modified lists the files the chat changed; choose View to open one.
Documents changed by the Agent are marked Modified by Agent in the workspace tree and tab strip, and Version history on a document records a version labelled Edited by the agent that you can restore.
Available tools vary by provider, model, pane, attached context, and installed kits. Do not assume that every chat can use every tool or that every write asks for confirmation.
Start with reversible work
- Begin with a read-only summary or search task
- Attach a small, known set of context
- Use Draft edits for kit documents you want to review before they change
- Inspect the timeline and Files modified before accepting the result
- Keep an independent backup before large workspace edits
Implementation sources
- kition@7d49036f: src/api/agent.ts
- kition@7d49036f: src/features/agent/hooks/useWorkspaceAgent.ts
- kition@7d49036f: src/features/agent/components/AgentAiComposer.tsx
- kition@7d49036f: src/features/agent/components/AgentContextAddMenu.tsx
- kition@7d49036f: src/features/agent/components/AgentConversation.tsx
- kition@7d49036f: src/features/agent/lib/agentKitEditMode.ts
- kition@7d49036f: src/features/kits/kition/KitDraftReview.tsx
- kition@7d49036f: src/features/workspace/components/WorkspaceAgentTabBar.tsx
- kition@7d49036f: crates/kition-workspacestorage/src/state.rs
- kition@7d49036f: crates/kition-agent/src/sources.rs
Related pages
Agent tool calls
Read the runtime tool names, how availability is decided, and the inputs, outputs, errors, and changed files shown in the Agent timeline.
Plans, drafts, and review
Distinguish the informational Agent plan card from the review steps that actually hold changes back: kit drafts and shell approvals.
Agent approvals and safety boundaries
Use the shell-command approval card and kit drafts without assuming Kition has a universal per-tool permission editor.