무료GitHub에 공개

boring-ui

Entry point for building with Boring UI (the @hachej/boring-* npm packages and shadcn registry blocks for apps with an AI agent inside, on the Pi agent harness). Use when a task mentions boring-ui, @hachej/boring-ui-kit, @hachej/boring-agent, @hachej/boring-files, boring-ui-blocks, PiChat, AgentWorkspace, AmbientChat, AppShell, or asks to "add an agent/assistant/chat to my app", "build an app with an agent inside", or "use the Boring kit". Explains the packages, the rules every change must follow, and which boring-ui skill to load next.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hachej/boring-ui

실행 점수 미검증

설치 방법 보기

포함된 파일(1)

SKILL.md5.1 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Boring UI

Boring UI is a kit for putting an AI agent inside an app. It has two halves:

npm packages for the server and headless browser code.
shadcn registry blocks (React source copied into the app) for the UI.

The agent runs on Pi (@earendil-works/pi-durable). The app's server opens Pi's Harness; the kit adds agent definitions, tools and HTTP handlers around it.

Pick the next skill

The task	Load
Create an app with an agent, or add an agent to an existing React/Node app	`build-agent-app`
Install, update, restyle or check UI blocks	`add-blocks`
Give the agent tools, file access, approvals, questions, sub-agents or schedules	`agent-capabilities`

Packages

Keep all @hachej/boring-* packages on the same version. Pi packages are peers pinned to ~1.2.0.

Package	Use it for
`@hachej/boring-ui-kit`	Headless controllers, editors and viewers; the registry items under `r/`; the `boring-ui-blocks` command
`@hachej/boring-agent`	`defineAgent` (`/agents`), chat transport (`/chat-transport`), conversations (`/conversations`), `present` (`/artifacts`), file guard (`/file-guard`), approvals (`/approval`), questions (`/ask-user`), schedules (`/schedule`), memory (`/memory/optchat`)
`@hachej/boring-files`	The workspace provider (`/workspace`), its journal (`/journal`, `/sqlite`), the browser revision provider (`/revision`) and its handler (`/revision-handler`), Node HTTP glue (`/node-http`)
`@hachej/boring-execution`	Virtual Bash and Git (`/virtual`, `/virtual-git`), remote shell and file system adapters
`@hachej/boring-feedback`	In-app feedback capture and delivery
`@earendil-works/pi-durable`, `pi-ai`, `chord`	Pi itself: `Harness`, `createRegistry`, `defineTool`, storage, `NodeExecutionEnv`, models, `context`

Main blocks: pi-chat (the conversation), pi-ambient (a floating bar over an existing site), pi-workspace (chat plus an artifact panel), pi-app (a whole agent page: sessions, chat, viewers), app-shell (one agent above any app, phone drawer and desktop panel). The full list is in registry/README.md.

Rules

Follow these on every change. They come from INVARIANTS.md and AGENTS.md.

The host owns the Harness. The app's server opens and closes Pi's Harness, its storage, its models and its credentials. Kit packages never open one. Do not wrap Pi in a new engine, registry or scheduler; use Pi's public APIs (defineTool, defineExtension, registry.install, conversation.configure).
The host owns policy. Authentication, who may open which conversation or file, budgets and model keys live in host code (the authenticate and resolve callbacks of the handlers). Never put a model key in browser code.
One place for files. Each workspace has exactly one provider instance (createWorkspaceProvider). The agent's file tools (through createFileGuard), present, the viewers and the file tree all use that same instance. No second copy, mirror or sync.
Use blocks, not hand-rolled UI. Install the registry blocks and customise them through their props (labels, icons, headerActions, artifactKinds, viewers, renderTool, …) and the shadcn theme tokens. Never edit an installed block file; npx boring-ui-blocks check fails on edited copies.
Agent-written code never runs in the host process. An agent may run code only through its conversation's ExecutionEnv (a shell or sandbox). Do not import() or eval workspace content.
Fictional data only in examples, fixtures, seeds and tests. Never use real people, credentials or customer data.

Where to read more

README.md: pitch, quickstart and package overview.
registry/README.md: every block, its props and install command.
packages/agent/README.md: agent tools, transport, approvals, schedules.
packages/files/README.md: the workspace provider and revision protocol.
MIGRATING.md: the newest version and what changed. Read its top section before upgrading.
docs/implementation/FEATURES.md: implemented APIs with their tests and limits.

Verify

The kit version: npm view @hachej/boring-ui-kit version. Use it for every @hachej/boring-* package and every registry URL.
In an app with blocks: npx boring-ui-blocks check --design src passes.
In this repository: npm run check passes.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬

add-blocks

무료

Find, install, update, check and theme Boring UI registry blocks (shadcn items such as pi-chat, pi-ambient, pi-workspace, pi-app, app-shell, viewers, file-tree, documents, feedback, windows) with the boring-ui-blocks command. Use when asked to "add a chat/agent block", "install pi-app", "upgrade/update the Boring blocks", "boring-ui-blocks check fails", "blocks edited", "restyle/rebrand the agent UI", "change the chat labels/icons/actions", "dark mode for the chat", or when tempted to edit a file under src/components/pi-*.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hachej/boring-ui492026년 10월 23일 업데이트

agent-capabilities

무료

Give a Boring UI in-app agent capabilities and gate them safely - custom tools, workspace file access (file guard, present), Approve/Deny approvals, ask_user questions, sub-agents (delegate), schedules, sandboxes and self-evolving tools. Use when asked to "add a tool to the agent", "let the agent edit files", "require approval before X", "ask the user a question", "add a sub-agent/delegate", "schedule a follow-up/reminder", "dry-run/sandbox the agent", "let the agent write its own tools", or when choosing which tools to gate with requireApproval or createApprovalExtension.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hachej/boring-ui492026년 10월 23일 업데이트

boring-pm

무료

The domain expert's product manager in a project repository run by the Boring Factory. Use when the expert brings a need or an idea, wants to clarify, change or resume a feature ("reprends la fiche"), asks what is happening with a feature, has a builder's question to answer, or has a preview to try and accept. Interviews one question at a time, writes the contract and mockups on the contract pull request, and submits the expert's approval only after the expert confirms. Never writes code.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hachej/boring-ui492026년 10월 23일 업데이트

build-agent-app

무료

Build a React + Node app with an AI agent inside using Boring UI, or add one to an existing app. Use when asked to "create an agent app", "add an AI assistant/chat/copilot to my app", "scaffold a Boring UI app", "wire AgentWorkspace/PiChat to a server", "set up the Pi Harness with the kit", or to connect the pi-app, pi-chat or pi-ambient blocks to defineAgent, createChatTransportHandler, createConversationsHandler and createRevisionHandler. Gives the verified smallest setup (one Node server, one page) and how to extend it.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hachej/boring-ui492026년 10월 23일 업데이트

hachej의 스킬 모두 보기

이 스킬의 문제 신고

설치

명령으로 설치

npx skills add https://github.com/hachej/boring-ui --skill boring-ui

터미널에 붙여 넣고 실행합니다(Node.js 필요). Claude Code, Codex 등 설치할 에이전트를 고를 수 있습니다.

에이전트에게 부탁하기

다음 Agent Skill을 설치해 주세요.
https://github.com/hachej/boring-ui/tree/main/skills/boring-ui

먼저 SKILL.md와 첨부 파일의 내용을 확인해 수상한 처리(외부 전송, 인증 정보 읽기 등)가 없는지 확인한 뒤 Claude Code는 ~/.claude/skills/boring-ui/, Codex는 ~/.agents/skills/boring-ui/ 에 배치해 주세요.

이 문장을 그대로 Claude Code나 Codex에 보내면 내용을 확인한 뒤 설치해 줍니다.

GitHub에서 소스 보기

저장소: hachej/boring-ui
스타: 49
포크: 2
카테고리: 디자인
라이선스: MIT
원문 언어: 영어
최종 업데이트: 2026년 10월 23일

스킬은 에이전트를 위한 지시와 스크립트의 묶음입니다. cccskills는 내용의 안전성을 보증하지 않습니다. 설치하기 전에 내용을 확인하세요.