com.themethodic由 themethodic.com 發布官方發布者v1.9.0更新於 Nov 8, 2026
Candor UI docs and component suggestions. Read-only, no key, never serves paid source.
Candor UI 的唯讀文件與元件建議服務，Candor UI 是供 AI 代理介面使用的 shadcn/ui React 元件登錄表。
Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/com.themethodic%2Fcandor/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。把它新增到你客戶端的 mcpServers 設定中。
{
"mcpServers": {
"candor-ui-docs": {
"type": "http",
"url": "https://candor.themethodic.com/mcp"
}
}
}Interface components for agent apps: a thread, messages, a composer, tool calls, reasoning and citations, the building blocks under them, a light, dark and high-contrast theme, and adapters for the Vercel AI SDK, the Claude Agent SDK and AG-UI. Built on shadcn, installed with its CLI, MIT licensed.
This repo is the source of Candor UI's 54 free items (version 1.9.0), the skill and plugins for coding agents and a starter app. Docs and live examples: https://candor.themethodic.com.
candor-ui init adds the @candor registry to components.json and the theme to your CSS; in a project without
shadcn yet it runs shadcn's setup first (--yes sets it up with Radix and shadcn's nova preset, no questions). Or add the registry by
hand: "@candor": "https://candor.themethodic.com/r/{name}.json". If shadcn asks to overwrite a primitive such as
ui/button.tsx, answer yes: Candor's button styles locked actions; without a terminal, pass --overwrite.
llms-install.md tells an agent how to set Candor up in a project by itself: the CLI, the docs MCP server, the skill
and the honesty rules to keep. The skill alone:
installs two skills: skills/candor-ui (which component fits which job, the adapters, and the rules the components
keep, with a design-system reference read from the shipped CSS) and skills/candor-agent-ui (design fundamentals for
screens where an AI agent acts, with a review checklist to run after each screen; it works with or without Candor).
The plugins install the skill and the docs MCP server together. Claude Code: claude plugin marketplace add MethodicDev/candor, then claude plugin install candor-ui@candor (or, in a session,
/plugin install candor-ui --marketplace MethodicDev/candor). GitHub Copilot CLI: copilot plugin marketplace add MethodicDev/candor, then copilot plugin install candor-ui@candor. VS Code installs candor-ui from this repo's URL;
Cursor reads .cursor-plugin/marketplace.json; the Codex package is plugins/codex/candor-ui.
The MCP server at https://candor.themethodic.com/mcp serves docs and component suggestions only: read-only, no key,
never paid source. .mcp/server.json describes it for the MCP registry. Agents can also read
https://candor.themethodic.com/llms.txt.
starter/ is a Next.js app with a working agent chat built from these components:
theme: Candor's default theme: light, dark and high contrast, contrast-checked. Import styles/candor.css after Tailwind.font-inter: Inter, Candor's default typeface, self-hosted (OFL-1.1). Optional: without it the theme uses the system font. Import styles/candor-font-inter.css next to candor.css.ag-ui: Turns AG-UI events into Candor messages, waiting approvals and usage, with AG-UI 1.0's shared state and activities.ai-sdk: Vercel AI SDK (v7) UI messages to Candor messages: text, reasoning, tool calls, sources and data cards.claude-agent-sdk: Turns Claude Agent SDK events into Candor messages, waiting approvals (and the agent's questions), usage and sources, and a person's answer back into the SDK's result.claude-agent-server: The server half of the Claude Agent SDK adapter: stream a run to useClaudeAgent, keep its permission requests in a store your own route can answer, and let a browser re-attach to a run after a reload.use-ag-ui: Wires an AG-UI agent to Candor: messages for /, props for , and the interrupts waiting on a person.use-candor-chat: Wires a useChat() result to Candor: messages for /, props for , and the tool calls waiting on a person.use-claude-agent: Wires a Claude Agent SDK server route to Candor: messages for /, props for , and the tool calls waiting on a person, re-attaching to a run after a reload.copy-field: A value a person copies somewhere else (a callback URL, a scope list).degraded-panel: Something couldn't be done.locale: The interface's words, language and direction.locked: The honest-state rule: a control that cannot be used says why.relative-time: A time as people say it ("5 minutes ago"), with the exact time on hover, safe to render on the server.status-dot: How many times the status reached done or failed from an unfinished one while the dot was on screen; zero when it mounted finished, so nothing moves for a change the reader never saw.step-list: How many times status has reached succeeded or failed from an unfinished status while this component was on screen.streaming-text: Text that is still arriving.surface: Candor's card: a plain, muted, bordered or floating surface, so no screen hand-rolls its own.terms: The app's words for its own concepts, so components read like the product: one app says "org", another "project" or "workspace".agent-avatar: An agent's glyph and hue by role, so people can tell agents apart at a glance.ai-disclosure: A plain notice that the person is interacting with an AI system: a first line in the thread (variant="line") or a compact "AI" badge for a thread header (variant="badge") that opens to the app's own explanation.attachment-preview: A file waiting to be sent, as a chip in the composer: its name, then upload progress, an error, or its size, and a remove button.card-registry: A card an agent's reply can carry.citation: An inline [n] that opens its source in a popover, so evidence is one step away without leaving the thread.composer: Where a person writes to the agent: @ mentions attach things as references, / starts a known action, and the scope says where the ask runs.context-meter: What fills the model's context budget, as a ring in the composer that opens to a breakdown: system, instructions, Know, the thread, tools, files.entity-chip: A thing in the user's system (a table, a record, a flow) as a chip with its kind's icon, that can open it.folded-turns: A run of turns folded into one line, for long agent work a reader doesn't need to see step by step: "Drafted three versions and compared them".message-actions: Copy, retry and rate under an agent's reply.message-content: A message's typed blocks (paragraphs, lists, code, tool calls, cards), rendered as text, never as markdown or HTML.message: One message in a thread.payload: A block of code or query text from the agent: a query it ran, code it wrote, a config file.permission-prompt: A tool call waiting for a person's go-ahead: what it will do, why it reached them, and the permission mode the run is in.prompt-suggestions: Prompts to start from.reasoning: The agent's stated reasoning above its answer.thread-divider: A rule across the thread with a label in the middle: a day ("Today", "Yesterday", "5 Nov 2026") or a chapter of the conversation ("Drafting", "Review").thread-event: A quiet, centred line in a thread for something that happened rather than something said: "Sam joined", "Switched to the staging environment", "Run stopped by a guardrail".thread: The scrolling message column.tool-call: One tool call as a compact row: what it did in plain words, its status, and how long it took.chat: The data a Candor thread renders.highlight: A small syntax highlighter for code an agent shows: it splits text into typed tokens (keyword, string, comment…), and Payload renders each as a span.know: The data behind the agents' knowledge base and agent settings.mcp-input: MCP's "input required" results (spec 2026-07-28, multi round-trip requests) as Candor data: a server's form becomes questions for ClarifyingQuestions, a plain confirmation or a link to open becomes a two-answer Decision for ApprovalDecision, and the person's answers become the inputResponses the client sends when it retries the call.render-prop: Lets Candor's Radix-based primitives also take Base UI's render prop.safe-markdown: Reads model text as safe markdown: paragraphs, lists and fenced code.status: The status vocabulary every Candor agent component shares.use-copy: Copy text and report what actually happened.use-shortcut: The keys of a combo as they should be printed: "mod+k" → ["⌘", "K"] on a Mac and ["Ctrl", "K"] elsewhere.use-virtual-list: Render only the items of a long list that are in or near view, for Thread's and SessionList's virtualize.button: shadcn's button in Candor's theme, with a locked state for (dimmed, and says why).collapsible: shadcn's collapsible (Radix) in Candor's theme.popover: shadcn's popover (Radix) in Candor's theme.skeleton: A loading placeholder in the shape of what's coming.tooltip: shadcn's tooltip (Radix) in Candor's theme.Plans, approvals, diffs, runs, evals, the app shell, admin screens, full-stack blocks and templates are in the paid tiers: https://candor.themethodic.com/#pricing.
This repo is generated from Candor UI's main repo on each release. Issues are welcome here; pull requests are read and applied upstream by hand, so they show up in the next release rather than being merged directly.
MIT, © Methodic LLC. See LICENSE. It covers this repository's free items; Candor UI's paid items are under the
Candor UI Commercial Licence.
來源：README.md，提交 2b0a37d
Search Candor UI docs
Search Candor UI's components, hooks, blocks and patterns by what they do ("approve a tool call", "cost estimate", "session list"). Returns names, tiers and one-line descriptions; read one with get_component_docs.
tierlimitquery必填Read a Candor UI docs page
Read one item's docs as Markdown: what it is, its tier and install command, an example with the import paths an app uses, every prop, function, type, and the LocaleProvider string keys.
name必填Suggest Candor UI components for a task
Describe the screen or feature you're building; get the Candor UI items that fit, why, the matching patterns, and one install command. Read each suggestion's docs before using it.
task必填tierList Candor UI components
List every item by group (Chat, Agent work, App shell, …), or one group's items with descriptions.
tiergroupRead a Candor UI pattern
Read a pattern as Markdown: a common problem in agent UIs (approvals, traces, cost guards, …) and the components that solve it.
slug必填How to set up Candor UI
How to install Candor UI in a React or Next.js app, render a chat, connect an agent SDK, add licensed items and keep them updated.
無需輸入參數。
A brief for a coding agent
One item's brief to hand to the coding agent that builds the screen: the same Markdown the docs page's "Copy for a coding agent" button copies (what the item is, its tier and install command, an example with the import paths an app uses, every prop, the string keys, and the rules to keep).
name必填Candor UI's design system
The design system as Markdown: every colour role and what it's for, the type scale, radius, shadows, motion, density and themes, read from the shipped CSS; how an app re-tokens for its brand; and how to build the screens around Candor components (surfaces, rhythm, writing, do and don't).
無需輸入參數。
Review checklist for agent UI screens
The checklist to run after each screen where an AI agent acts, before moving on: one line per check, each tied to a rule (model output is text, unknown stays unknown, a locked control says why, nothing pre-selected, approve the exact change, reasoning is believed, the app names the agent, say what can be undone, plus status, progress and accessibility). From the candor-agent-ui skill; works with or without Candor.
無需輸入參數。
已滿足適用檢查項的 100%
該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。
npx candor-ui initnpx candor-ui add thread message composernpx skills add MethodicDev/candornpx degit MethodicDev/candor/starter my-agent-app