Getting Started
Dashboard
Chat is the primary way users build. The agent streams replies, runs tools, writes files, and can inspect the live preview in a browser-like pipeline.
POST …/workspace/chat/attachment)| Element | Meaning |
|---|---|
| Thinking | Collapsible “Thought for N s” from <Thinking>…</Thinking> |
| Tool cards | Active/complete labels (taskNameActive / taskNameComplete) |
| File write cards | Fenced lang file="path" blocks applied to the workspace |
| Clarifying questions | Structured <ClarifyingQuestions> JSON — one question at a time with radio options |
| Credits | Balance; insufficient → upgrade drawer |
Stream: GET …/chat/stream/{messageId} (SSE).
Cancel: POST …/agent/sessions/{sessionId}/cancel.
Optional notification sounds when a run finishes (admin: Lab Console).
When the goal is ambiguous, the agent asks structured questions instead of free-form bullets. Answers return as a follow-up user message; then implementation continues.
Schemas live in resources/prompts/Builder/Tools.json (runtime meta in config/builder_tools.php).
| Tool | What it does |
|---|---|
parse_ui | Structured UI → file writes |
GetOrRequestIntegration | Check/request Supabase (and similar) before inventing backends |
ApplySupabaseMigration | Propose SQL migration (user Allow/Skip) |
GenerateDesignInspiration | Design brief for the project |
TodoManager | Plan tasks: set / move / add / read / mark done |
| Directive | Format |
|---|---|
| Write / edit | Fenced code with file="path" |
| Delete | <Delete File file="path" /> |
| Move | <Move File from="…" to="…" /> |
Typical tool order: parse_ui → integrations → migrations → design inspiration → todos → search/ls/read → web → InspectSite.
InspectSite is how the agent “looks at” the running site:
InspectSite with preview URLsThis pairs with user Inspect mode (click-to-select + inspector) described in Workspace.
TodoManager streaming creates a checklist. The composer shows Project tasks. Users can follow plan stages before heavy generation.
After edits, Krikkit can run npm run build and open a background-fix stream if the build fails (…/agent/background-fix). Limits: KRIKKIT_BUILDER_CHAT_AUTOFIX_MAX_ATTEMPTS, product repair caps.
| Env / config | Role |
|---|---|
KRIKKIT_BUILDER_CHAT_MAX_MESSAGES | History window |
KRIKKIT_BUILDER_CHAT_HISTORY_MAX_CHARS | Context size |
KRIKKIT_BUILDER_CHAT_MAX_TOOL_ROUNDS | Tools per turn |
KRIKKIT_BUILDER_CHAT_MAX_CONTINUATIONS | Continuations |
KRIKKIT_CREDITS_* | Metering |
KRIKKIT_READ_FILE_MAX_RESULT_BYTES |
SearchRepo| Semantic/path search across the workspace |
GrepRepo | Regex search |
LSRepo | List directories |
ReadFile | Read file (optional line range / query) |
SearchWeb | Web search (KRIKKIT_WEB_SEARCH_*, Brave optional) |
FetchFromWeb | Fetch page text |
InspectSite | Browser-style screenshots of live or localhost URLs (localhost remapped to the project preview). Uses KRIKKIT_SCREENSHOT_API_URL + KRIKKIT_SCREENSHOT_API_KEY |
| ReadFile cap |