Menu
Start and manage Agent Chat conversations from scripts, including typed context parts, streaming status, and chat lifecycle operations.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Agent-facing DevTools for Script Kit GPUI: use protocol, MCP, and CLI primitives to inspect, control, measure, debug, benchmark, and prove real app UI behavior from bug reports without defaulting to prewritten agentic-testing recipes.
Manage the Notes window — creating, searching, editing, and automating notes via the SDK and automation protocol.
Use the local agy CLI as a fast Script Kit GPUI app inspector by prompting it to drive existing script-kit-devtools primitives, capture logs, and produce a compact investigation result from a user bug report or inspection prompt.
Add Actions Menu commands to scripts and scriptlet bundles with setActions() and companion .actions.md files.
Configure external MCP servers for scripts and Agent Chat. Use when the user wants to add, remove, enable, disable, or inspect MCP servers in Script Kit.
Create or update scriptlet bundles for text expansions, snippets, shell commands, and lightweight helpers in a single markdown file.
| name | start-chat |
| description | Start and manage Agent Chat conversations from scripts, including typed context parts, streaming status, and chat lifecycle operations. |
Use this skill when the user wants a script that opens Agent Chat, continues a chat, injects typed context parts, checks streaming, or deletes/focuses chats.
~/.scriptkit/plugins/main/scripts/<name>.ts
import "@scriptkit/sdk";
const result = await aiStartChat("Summarize this context", {
systemPrompt: "Be concise",
modelId: "claude-3-5-sonnet-20241022",
parts: [
{ kind: "resourceUri", uri: "kit://context?profile=minimal", label: "Current Context" },
],
});
await aiSendMessage(result.chatId, "Now inspect this file", undefined, [
{ kind: "filePath", path: "/tmp/example.rs", label: "example.rs" },
]);
const status = await aiGetStreamingStatus(result.chatId);
await aiFocus();
if (!status.isStreaming) {
await aiDeleteChat(result.chatId, false);
}
aiStartChat() — start a new Agent Chat threadaiSendMessage() — continue an existing threadaiAppendMessage() — seed history without triggering a responseaiOn() — subscribe to streaming eventsaiGetStreamingStatus() — poll stream stateaiFocus() — bring Agent Chat forwardaiDeleteChat() — soft-delete or permanently delete a chatSupported parts entries:
{ kind: "resourceUri", uri, label }{ kind: "filePath", path, label }Use kit://context?profile=minimal for current desktop context.
chat() only for inline prompt UIs.parts are typed attachments, not free-form text blobs.~/.scriptkit/plugins/examples/scriptlets/agent_chat-chat/main.md — start chats, attach typed context parts, and inspect streaming status~/.scriptkit/plugins/examples/scriptlets/agent_chat-chat.md — auto-generated flat copy of the canonical source