Candor UI docs

Name: Candor UI docs
Author: MethodicDev

作者：MethodicDev版本 1.9.0i★ –i在云端运行

注册名称com.themethodic/candor

安装

概览

作者提供的说明（英文原文）

Candor UI docs and component suggestions. Read-only, no key, never serves paid source.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i3 项中通过 2 项依据公开信息检查；尚未扫描代码
使用情况i起步阶段★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在云端运行
传输方式: Streamable HTTP
分类: 其他

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：3 项中通过 2 项
在作者的服务器上运行：你向它提出的内容会经过他们的服务器。
可以做 9 件事（工具） search_docs, get_component_docs, suggest_components, list_components …
注册中心没有列出需要填写的密钥。

你需要

在云端运行无需安装任何东西，通过互联网连接

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

适用于网页版、桌面版和手机版 Claude：

打开 Settings → Connectors
点击 Add custom connector
粘贴下面的地址，然后点击 Add
如果要求登录，请登录作者的服务

https://candor.themethodic.com/mcp

在终端中运行这条命令

claude mcp add --transport http candor https://candor.themethodic.com/mcp

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "candor": {
      "url": "https://candor.themethodic.com/mcp"
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "candor": {
      "type": "http",
      "url": "https://candor.themethodic.com/mcp"
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

ChatGPT 只能连接互联网上的服务器：

打开网页版 ChatGPT → Settings → Connectors (Apps)
点击 Create 或 Add（部分套餐需要先在 Advanced 中开启 Developer mode）
粘贴下面的地址，起个名字，然后保存
如果要求登录，请登录作者的服务

https://candor.themethodic.com/mcp

菜单名称可能因套餐和版本不同而略有差异。

你的选择通过 Cookie 保存在这台设备上，无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

工具名称和描述与服务器在 2026年11月8日报告的完全一致。这些内容由作者撰写，不是我们写的；我们以纯文本形式显示。

search_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.
get_component_docs
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.
suggest_components
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.
list_components
List every item by group (Chat, Agent work, App shell, …), or one group's items with descriptions.
get_pattern
Read a pattern as Markdown: a common problem in agent UIs (approvals, traces, cost guards, …) and the components that solve it.
get_started
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.
get_brief
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
get_design
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
get_review_checklist
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 t

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日

! 注意
作者与仓库一致
发布者（themethodic.com）不是仓库所有者（MethodicDev）；可能是其他人代为上架的
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
✓ 通过
端点有响应
在 329 毫秒内响应（HTTP 200）
– 不适用
使用 OAuth 登录
无需登录
✓ 通过
工具描述中没有隐藏指令
已读取 9 个工具描述，未发现针对 AI 的隐藏指令

与“其他”中的其他服务器比较i

星标数多于此分类中其他 18513 个服务器的 0%
发布到注册中心的时间比此分类中其他 18513 个服务器的 99% 更新
基础检查结果等于或优于此分类中其他 18513 个服务器的 36%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Candor UI docs 安全吗？

它在 3 项适用的基础检查中通过了 2 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在作者的云端运行。通过互联网连接，无需安装，但你发送的内容会经过作者的服务器。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（1.9.0）于今天进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接，所以接受远程 MCP 服务器的应用也可以使用，例如开启开发者模式的 ChatGPT。

有什么可以替代它？

同一分类中有：Spec Driven Development, Remote Desktop Commander, Cape Winelands Visit Planner

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

作者：formulahendry起步阶段↓ 66/周★ 44014个月前更新

在你的电脑上运行

安装

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

作者：desktop-commander正在增长★ 2113天前更新

在云端运行✓ desktopcommander.app

安装

Cape Winelands Visit Planner

Cape Winelands wine farm finder and day-route planner

作者：aiagenttools.co.za起步阶段今天更新

在云端运行✓ aiagenttools.co.za

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Candor UI: the free tier

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.

Install

npx candor-ui init

npx candor-ui add thread message composer

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.

For coding agents

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:

npx skills add MethodicDev/candor

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

starter/ is a Next.js app with a working agent chat built from these components:

npx degit MethodicDev/candor/starter my-agent-app

What's here

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.

Pro and Premium

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.

Contributing

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.

Licence

MIT, © Methodic LLC. See LICENSE. It covers this repository's free items; Candor UI's paid items are under the Candor UI Commercial Licence.