diff --git a/README.md b/README.md index cf98fa8b..7a973f68 100644 --- a/README.md +++ b/README.md @@ -37,7 +37,8 @@ ## What's new -- **v0.1.4** *(coming)* — 🎨 AI image generation · ChatGPT Plus/Codex subscription support · CLIProxyAPI one-click import · API config hardening +- **v0.2.0** *(in preparation, expected in about a week)* — Agentic Design: workspace-backed design sessions · permissioned file/tool loop · lazy skills and scaffolds · `DESIGN.md` design systems +- **v0.1.4** *(2026-04-23)* — AI image generation · ChatGPT Plus/Codex subscription support · CLIProxyAPI one-click import · API config hardening - **v0.1.3** *(2026-04-21)* — Gemini `models/` prefix fix · OpenAI-compatible relay "instructions required" fix · third-party relay SSE-truncation hint - **v0.1.2** *(2026-04-21)* — Release pipeline · Homebrew / winget / Scoop packaging manifests @@ -226,6 +227,7 @@ Add a `SKILL.md` to any project to teach the model your own taste. - **Prompt → HTML or JSX/React component** prototype, rendered in a sandboxed iframe (vendored React 18 + Babel on-device) - **Fifteen built-in demos + twelve design skill modules** — ready-to-edit starting points for common design briefs - **Live agent panel** — watch tool calls stream in real time as the model edits files +- **AI image generation** — opt-in bitmap assets for heroes, product shots, backgrounds, and illustrations - **AI-generated sliders** — the model emits the parameters worth tweaking (color, spacing, font) - **Comment mode** — click any element in the preview to drop a pin, leave a note, and let the model rewrite only that region - **Generation cancellation** — stop mid-stream without losing prior turns @@ -247,20 +249,28 @@ Add a `SKILL.md` to any project to teach the model your own taste. ## Roadmap -We're on v0.1.3 — shipping fast, priorities can shift. This is what's on the bench right now. +Current release: v0.1.4. The next release theme is locked: **Agentic Design**. -### Now — v0.1.x polish +### Now — v0.1.4 shipped -- **Provider & API config polish** — smoother one-click import, model picker reaching the last gaps (custom providers, timeouts), clearer connection diagnostics -- **Structured logging + issue-report bundle** — better logs in the main/renderer processes and a one-click diagnostics export that makes bug reports actionable +- **AI image generation** — opt-in bitmap assets through OpenAI image models or OpenRouter image models +- **ChatGPT Plus / Codex subscription login** — one-click OAuth for users who do not want to paste an API key +- **CLIProxyAPI one-click import** — auto-detect a running local proxy and bring it into Settings +- **API config hardening** — clearer relay diagnostics for timeouts, SSE truncation, missing `/models`, and incompatible Messages APIs -### Next — v0.2 (headline theme: filesystem & import) +### Next — v0.2.0 (Agentic Design) -- **Filesystem support** — read/write real project directories, not just in-app scratch space -- **Broader import paths** — bring existing assets, prompts, and project context into a design session +Expected in about a week. v0.2 turns Open CoDesign from a one-shot generator into a local design agent with a real workspace: -### Later — v0.3 and beyond +- **Design as session** — every design is a pi session with JSONL history and a workspace folder on disk +- **Permissioned agent loop** — pi built-ins for read, write, edit, bash, grep, find, and ls, gated by Open CoDesign's permission UI +- **Design tools on demand** — `ask`, `scaffold`, `skill`, `preview`, `gen_image`, `tweaks`, `todos`, and `done` +- **`DESIGN.md` as shared memory** — brand tokens and design-system decisions become editable files, not model memory +- **v0.1 migration path** — existing SQLite designs migrate into workspaces and session history +### Later — v0.2.x and beyond + +- Renderer polish for the new `ask`, `preview`, tweaks, and process-management surfaces - Cost transparency — pre-generation estimate + weekly budget (per-generation token count already shipped) - Version snapshots + side-by-side diff - Three-style parallel exploration @@ -289,7 +299,7 @@ Have a different priority in mind? [Open an issue](https://github.com/OpenCowork ## Built on - Electron + React 19 + Vite 6 + Tailwind v4 -- `@mariozechner/pi-ai` (multi-provider model abstraction) +- `@mariozechner/pi-ai` and `pi-coding-agent` (model/provider and agent-loop primitives) - `better-sqlite3`, `electron-builder` ## Reporting issues @@ -325,7 +335,7 @@ For Chinese-speaking users, we also keep a WeChat group for product updates, usa />

-> ⚠️ The WeChat QR code rotates every 7 days and is currently valid until **April 28**. +> ⚠️ The WeChat QR code rotates every 7 days and is currently valid until **May 4**. > If the code has expired, please leave a message in [GitHub Issues](https://github.com/OpenCoworkAI/open-codesign/issues) and we will refresh the image in-repo. See also the Chinese README: [README.zh-CN.md#社群](./README.zh-CN.md#%E7%A4%BE%E7%BE%A4). diff --git a/README.zh-CN.md b/README.zh-CN.md index b23b85f2..678ba0ec 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -35,7 +35,8 @@ ## 最近更新 -- **v0.1.4** *(即将发布)* — 🎨 AI 图像生成 · 支持 ChatGPT Plus / Codex 订阅登录 · CLIProxyAPI 一键导入 · API 配置稳定性优化 +- **v0.2.0** *(准备中,预计一周左右发布)* — Agentic Design:带真实工作区的设计会话 · 带权限的文件 / 工具循环 · 按需加载 skill 和 scaffold · `DESIGN.md` 设计系统 +- **v0.1.4** *(2026-04-23)* — AI 图像生成 · 支持 ChatGPT Plus / Codex 订阅登录 · CLIProxyAPI 一键导入 · API 配置稳定性优化 - **v0.1.3** *(2026-04-21)* — 修复 Gemini `models/` 前缀 key · 修复 OpenAI 兼容中转 "instructions required" 报错 · 新增第三方中转 SSE 截断提示 - **v0.1.2** *(2026-04-21)* — 发版流程 · Homebrew / winget / Scoop 打包清单 @@ -224,6 +225,7 @@ brew install --cask opencoworkai/tap/open-codesign - **提示词 → HTML 或 JSX/React 组件原型**,渲染在隔离的 sandbox iframe 中(本地 vendored React 18 + Babel) - **十五个内置 demo + 十二个设计技能模块**:给常见设计需求准备好的起点 - **实时 Agent 面板**:模型编辑文件时,工具调用会实时流式展示 +- **AI 图像生成**:可选启用,为 hero、产品图、背景和插画生成位图素材 - **AI 自动生成调节参数**:模型会主动暴露值得调的参数,比如颜色、间距和字体 - **Comment mode**:点击预览中的任意元素,留下批注,模型只重写对应局部 - **支持中途取消生成**:停止后也不会丢失之前的上下文和结果 @@ -245,20 +247,28 @@ brew install --cask opencoworkai/tap/open-codesign ## Roadmap -当前版本 v0.1.3,处于快速迭代阶段,优先级随时会调整。下面是我们现在案头上的事。 +当前版本是 v0.1.4,v0.2.0 正在准备中。优先级仍可能调整,但下一版主题已经确定:**Agentic Design**。 -### Now — v0.1.x 打磨 +### Now — v0.1.4 已发布 -- **Provider / API 配置打磨**:一键导入体验更顺滑,model picker 补齐最后的缺口(自定义 provider、timeout),连接诊断给出更清晰的错误提示 -- **结构化日志 + 问题汇报包**:完善主进程 / 渲染进程的日志,一键导出诊断包,让 bug report 真正能被复现 +- **AI 图像生成**:通过 OpenAI 图像模型或 OpenRouter 图像模型生成位图素材,默认关闭,可在设置里启用 +- **ChatGPT Plus / Codex 订阅登录**:一键 OAuth,适合不想手动粘贴 API Key 的用户 +- **CLIProxyAPI 一键导入**:自动发现正在运行的本地代理,并带入 Settings +- **API 配置稳定性优化**:对 timeout、SSE 截断、缺少 `/models`、Messages API 不兼容等中转问题给出更清楚的诊断 -### Next — v0.2(主题:文件系统与导入) +### Next — v0.2.0(Agentic Design) -- **文件系统支持**:直接读写真实的项目目录,而不只是 app 内的临时空间 -- **更丰富的导入能力**:把已有的素材、prompt、项目上下文带进设计会话 +预计一周左右发布。v0.2 会把 Open CoDesign 从一次性生成器升级成一个本地设计 agent,每个设计都有真实工作区: -### Later — v0.3 及之后 +- **Design as session**:每个 design 都是一个 pi session,历史写入 JSONL,产物落在磁盘工作区 +- **带权限的 agent loop**:复用 pi 的 read、write、edit、bash、grep、find、ls,由 Open CoDesign 权限 UI 统一拦截 +- **按需调用设计工具**:`ask`、`scaffold`、`skill`、`preview`、`gen_image`、`tweaks`、`todos`、`done` +- **`DESIGN.md` 作为设计系统源文件**:品牌 token 和设计决策写成可编辑文件,而不是存在模型记忆里 +- **v0.1 迁移路径**:旧 SQLite 设计会迁移到真实工作区和 session history +### Later — v0.2.x 及之后 + +- 继续打磨新版 `ask`、`preview`、tweaks 和进程管理界面 - 成本透明化:生成前估算 + 每周预算控制(每轮 token 计数已上线) - 版本快照 + 并排 diff - 三种风格并行探索 @@ -279,7 +289,7 @@ brew install --cask opencoworkai/tap/open-codesign ## 基于这些技术构建 - Electron + React 19 + Vite 6 + Tailwind v4 -- `@mariozechner/pi-ai`(多 provider 模型抽象) +- `@mariozechner/pi-ai` 与 `pi-coding-agent`(模型 / provider 与 agent loop 基础能力) - `better-sqlite3`、`electron-builder` ## 社群 @@ -296,7 +306,7 @@ Open CoDesign 在 [LINUX DO](https://linux.do/) 社区首发,感谢佬友们 Open CoDesign 用户交流群微信二维码

-> ⚠️ 微信群二维码每 7 天自动失效(当前截至 **4 月 28 日** 有效)。扫码失败请到 [GitHub Issues](https://github.com/OpenCoworkAI/open-codesign/issues) 留言,我们会更新这里的图片。 +> ⚠️ 微信群二维码每 7 天自动失效(当前截至 **5 月 4 日** 有效)。扫码失败请到 [GitHub Issues](https://github.com/OpenCoworkAI/open-codesign/issues) 留言,我们会更新这里的图片。 英文或异步讨论:[GitHub Issues](https://github.com/OpenCoworkAI/open-codesign/issues) · 安全问题:[SECURITY.md](./SECURITY.md)。 diff --git a/package.json b/package.json index 41c14692..4eade943 100644 --- a/package.json +++ b/package.json @@ -2,6 +2,7 @@ "name": "open-codesign", "version": "0.1.4", "private": true, + "type": "module", "description": "Open-source AI design tool — prompt to interactive prototype, slide deck, and marketing assets. Multi-model, BYOK, runs on your laptop.", "license": "MIT", "homepage": "https://github.com/OpenCoworkAI/open-codesign", diff --git a/packages/core/src/design-skills/index.ts b/packages/core/src/design-skills/index.ts index 48f0f679..730977c4 100644 --- a/packages/core/src/design-skills/index.ts +++ b/packages/core/src/design-skills/index.ts @@ -7,18 +7,15 @@ * skill (if any) applies before opening the file. */ -import calendarJsx from './calendar.jsx?raw'; -import chartSvgJsx from './chart-svg.jsx?raw'; -import chatUiJsx from './chat-ui.jsx?raw'; -import dashboardJsx from './dashboard.jsx?raw'; -import dataTableJsx from './data-table.jsx?raw'; -import editorialTypographyJsx from './editorial-typography.jsx?raw'; -import footersJsx from './footers.jsx?raw'; -import glassmorphismJsx from './glassmorphism.jsx?raw'; -import heroesJsx from './heroes.jsx?raw'; -import landingPageJsx from './landing-page.jsx?raw'; -import pricingJsx from './pricing.jsx?raw'; -import slideDeckJsx from './slide-deck.jsx?raw'; +import { readFileSync } from 'node:fs'; +import { dirname, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; + +const __dirname = dirname(fileURLToPath(import.meta.url)); + +function loadSkill(name: string): string { + return readFileSync(resolve(__dirname, name), 'utf-8'); +} const DESIGN_SKILL_FILES = [ 'slide-deck.jsx', @@ -38,16 +35,16 @@ const DESIGN_SKILL_FILES = [ export type DesignSkillName = (typeof DESIGN_SKILL_FILES)[number]; export const DESIGN_SKILLS: ReadonlyArray = Object.freeze([ - ['slide-deck.jsx', slideDeckJsx], - ['dashboard.jsx', dashboardJsx], - ['landing-page.jsx', landingPageJsx], - ['chart-svg.jsx', chartSvgJsx], - ['glassmorphism.jsx', glassmorphismJsx], - ['editorial-typography.jsx', editorialTypographyJsx], - ['heroes.jsx', heroesJsx], - ['pricing.jsx', pricingJsx], - ['footers.jsx', footersJsx], - ['chat-ui.jsx', chatUiJsx], - ['data-table.jsx', dataTableJsx], - ['calendar.jsx', calendarJsx], + ['slide-deck.jsx', loadSkill('slide-deck.jsx')], + ['dashboard.jsx', loadSkill('dashboard.jsx')], + ['landing-page.jsx', loadSkill('landing-page.jsx')], + ['chart-svg.jsx', loadSkill('chart-svg.jsx')], + ['glassmorphism.jsx', loadSkill('glassmorphism.jsx')], + ['editorial-typography.jsx', loadSkill('editorial-typography.jsx')], + ['heroes.jsx', loadSkill('heroes.jsx')], + ['pricing.jsx', loadSkill('pricing.jsx')], + ['footers.jsx', loadSkill('footers.jsx')], + ['chat-ui.jsx', loadSkill('chat-ui.jsx')], + ['data-table.jsx', loadSkill('data-table.jsx')], + ['calendar.jsx', loadSkill('calendar.jsx')], ] as const); diff --git a/packages/core/src/frames/index.ts b/packages/core/src/frames/index.ts index 7ffc58d7..a18045ed 100644 --- a/packages/core/src/frames/index.ts +++ b/packages/core/src/frames/index.ts @@ -9,11 +9,15 @@ * EDITMODE block at the top so the host can render a tweak panel. */ -import androidJsx from './android.jsx?raw'; -import ipadJsx from './ipad.jsx?raw'; -import iphoneJsx from './iphone.jsx?raw'; -import macosSafariJsx from './macos-safari.jsx?raw'; -import watchJsx from './watch.jsx?raw'; +import { readFileSync } from 'node:fs'; +import { dirname, resolve } from 'node:path'; +import { fileURLToPath } from 'node:url'; + +const __dirname = dirname(fileURLToPath(import.meta.url)); + +function loadFrame(name: string): string { + return readFileSync(resolve(__dirname, name), 'utf-8'); +} const FRAME_FILES = [ 'iphone.jsx', @@ -26,9 +30,9 @@ const FRAME_FILES = [ export type FrameName = (typeof FRAME_FILES)[number]; export const FRAME_TEMPLATES: ReadonlyArray = Object.freeze([ - ['iphone.jsx', iphoneJsx], - ['ipad.jsx', ipadJsx], - ['watch.jsx', watchJsx], - ['android.jsx', androidJsx], - ['macos-safari.jsx', macosSafariJsx], + ['iphone.jsx', loadFrame('iphone.jsx')], + ['ipad.jsx', loadFrame('ipad.jsx')], + ['watch.jsx', loadFrame('watch.jsx')], + ['android.jsx', loadFrame('android.jsx')], + ['macos-safari.jsx', loadFrame('macos-safari.jsx')], ] as const); diff --git a/website/faq.md b/website/faq.md index aa195641..4adc965e 100644 --- a/website/faq.md +++ b/website/faq.md @@ -63,7 +63,7 @@ Yes. Open CoDesign supports ChatGPT Plus / Codex OAuth subscription login as of ## Does Open CoDesign send my prompts or designs to any third party? -No. All designs, prompts, snapshots, and codebase scans live on your machine — SQLite for design history, and a TOML config at `~/.config/open-codesign/config.toml` with file mode 0600 (matching Claude Code / Codex / gh CLI conventions). The only outbound network traffic is directly to the model provider you configure with your own API key. No telemetry by default. +No. Designs, prompts, and scans live on your machine. v0.1 uses SQLite for design history plus a TOML config at `~/.config/open-codesign/config.toml` with file mode 0600; v0.2 migrates designs into JSONL sessions and workspace files. The only outbound network traffic is directly to the model provider you configure with your own API key. No telemetry by default. ## Which AI models does Open CoDesign support? @@ -123,17 +123,17 @@ Yes, when used with a local model runtime like Ollama. All generation flows thro ## What's coming in v0.2? -v0.2 is an architectural upgrade — the "Agentic Design Loop". Instead of a one-shot prompt-to-artifact generator, v0.2 gives you: +v0.2 is the Agentic Design update, expected in about one week. It turns Open CoDesign from a one-shot prompt-to-artifact generator into a local design agent: -- **Per-project workspace** — bind any folder on disk; all generated files live there, usable with git -- **Agent reads your workspace** — `read_file`, `list_files`, `grep`, `find` tools so the agent understands context before generating -- **Agent edits real files** — str-replace-style targeted edits plus full-file writes, with opt-in permission UX -- **Point-and-prompt revision** — click any region in the preview, describe the change, the agent edits just that region -- **Visual verification** — the agent can screenshot its own preview to verify what it built -- **Progressive skill disclosure** — design skills become tool-invoked resources instead of always-injected prompt text -- **Snapshot-per-turn rollback** — never lose a good iteration +- **Workspace-backed designs** — every design is a pi session with JSONL history and real files on disk +- **Permissioned local tools** — read, write, edit, bash, grep, find, and ls flow through Open CoDesign's permission UI +- **Design-specific tools** — `ask`, `scaffold`, `skill`, `preview`, `gen_image`, `tweaks`, `todos`, and `done` +- **Preview self-checks** — the agent can render artifacts, inspect console and asset errors, and use screenshots when the model supports vision +- **Progressive skill disclosure** — design skills, scaffolds, and brand references lazy-load when the agent needs them +- **`DESIGN.md` as design-system memory** — brand values and tokens stay in editable files, not model memory +- **v0.1 migration** — existing SQLite designs migrate into workspaces and session history -The full design doc is public and under community review. See the [roadmap](/roadmap) for the milestone plan. +See the [roadmap](/roadmap) for the milestone plan. ## Is Open CoDesign secure? diff --git a/website/index.md b/website/index.md index 9e37895b..8825e0ea 100644 --- a/website/index.md +++ b/website/index.md @@ -7,7 +7,7 @@ description: Open CoDesign is an open-source desktop AI design tool — a self-h hero: name: Open CoDesign text: Design with intent. - tagline: An open-source desktop AI design tool. Bring your own model, keep everything local — a self-hosted alternative to Claude Design, built for teams who can't afford subscription lock-in. + tagline: An open-source desktop AI design tool. v0.1.4 is out; v0.2.0 is preparing the Agentic Design update with workspace-backed sessions and permissioned local tools. image: src: /logo-hero.png alt: Open CoDesign — open-source AI design tool @@ -31,7 +31,7 @@ features: details: Already using Claude Code or Codex? Open CoDesign reads your existing config — providers, models, API keys — and brings it all in with a single click. - icon: 🏡 title: Your laptop is the cloud - details: Designs, prompts, codebase scans — SQLite + encrypted TOML on disk. No mandatory account, no telemetry by default. 100% local. + details: Designs, prompts, and settings stay on disk. v0.1 keeps design history in local SQLite; v0.2 moves sessions into JSONL plus real workspace files. No mandatory account, no telemetry by default. - icon: 🪄 title: Twelve design skills, not magic details: Twelve built-in design skill modules ship out of the box — dashboards, landing pages, slide decks, pricing pages, chat UIs, data tables, calendars, glassmorphism, editorial typography and more. Drop a SKILL.md into any project to teach the model your own taste. @@ -40,7 +40,7 @@ features: details: The model emits the parameters worth tweaking — color, spacing, font — and you drag to refine. No round-tripping the LLM for every nudge. - icon: 🔀 title: Instant design switching - details: Hop between your last five designs with zero delay. Preview iframes stay alive in memory — no reparse, no white flash, no waiting for snapshots to reload. + details: Hop between your last five designs with zero delay. Preview iframes stay alive in memory, so there is no reparse, white flash, or reload wait. - icon: 📱 title: Desktop, tablet, phone details: Preview any artifact in a true phone frame or tablet width, side-by-side with the full canvas. See the responsive story before you export. @@ -48,11 +48,11 @@ features: title: Comment, don't retype details: Click any element in the preview to drop a pin. Leave a note. The model rewrites only that region — no more re-prompting the whole page to move a button. - icon: 🧬 - title: Codebase to design system - details: Point at a local repo. We extract Tailwind tokens, CSS vars, and W3C design tokens — every subsequent generation respects them. Coming soon. + title: "v0.2: Agentic Design" + details: Each design becomes a long-running session with a real workspace. The agent can read, edit, run permissioned tools, preview its work, and keep design-system decisions in files. - icon: 📐 - title: Versions, diffs, snapshots - details: Every iteration is a snapshot. Diff two versions side-by-side. Roll back. Fork. The history Claude Design doesn't have. Coming soon. + title: DESIGN.md as memory + details: Brand values and design tokens live in DESIGN.md, not model memory. Bring your own design system, or let the agent write one as the artifact evolves. - icon: 💸 title: Cost transparency details: Token estimate before each generation. Weekly spend in the toolbar. Set a budget, get warned, never get surprised. Coming soon. @@ -85,7 +85,7 @@ import { withBase } from 'vitepress'
3

Refine, export, hand off

-

Inline comments, AI sliders, snapshot timeline. Export to HTML, PDF, PPTX, ZIP, or Markdown — all on-device.

+

Inline comments, AI sliders, and local files. Export to HTML, PDF, PPTX, ZIP, or Markdown — all on-device.

@@ -112,7 +112,7 @@ import { withBase } from 'vitepress'
Your Designs hub, filled with real generated artifacts -
Every iteration, kept. Designs live on disk as SQLite snapshots; switch between five in zero ms.
+
Every iteration, kept. Designs are saved locally; v0.2 moves sessions into JSONL plus real workspace files.
Built-in example library — fifteen ready-to-run design briefs diff --git a/website/public/community/wechat-group.jpg b/website/public/community/wechat-group.jpg index 064c32f8..67805082 100644 Binary files a/website/public/community/wechat-group.jpg and b/website/public/community/wechat-group.jpg differ diff --git a/website/public/llms-full.txt b/website/public/llms-full.txt index 62346066..8067cb82 100644 --- a/website/public/llms-full.txt +++ b/website/public/llms-full.txt @@ -37,7 +37,7 @@ The generation pipeline: prompt → `@mariozechner/pi-ai` (provider abstraction) | Keyless proxy support | Yes (IP allowlist) | No | No | No | No | | Local / offline | Fully local | Cloud | Cloud | Cloud | Cloud | | Models | Any (Claude, GPT, Gemini, DeepSeek, Ollama, OpenRouter, SiliconFlow, …) | Claude Opus only | GPT-4o | Multi-LLM | Multi-LLM | -| Version history | Local SQLite snapshots | None | None | None | None | +| Version history | Local first: v0.1 SQLite snapshots; v0.2 JSONL sessions + workspace files | None | None | None | None | | Data privacy | 100% on-device | Cloud-processed | Cloud | Cloud | Cloud | | Built-in design skills | 12 skill modules + 15 demo prompts | No | No | No | No | | Config import | Claude Code + Codex in one click | No | No | No | No | @@ -60,7 +60,7 @@ open-codesign uses a monorepo managed with pnpm workspaces and Turborepo: - `packages/i18n` — i18next locales (English + 简体中文) - `website` — VitePress marketing + docs site -Storage: better-sqlite3 for design history and snapshots; TOML files (encrypted via Electron safeStorage) for configuration. No electron-store blob. All paths respect XDG base dirs and Electron `app.getPath()`. +Storage: v0.1 uses better-sqlite3 for design history and snapshots plus TOML files for configuration. v0.2 migrates design history into pi JSONL sessions and stores generated artifacts, assets, exports, AGENTS.md, and DESIGN.md in real workspace folders. No electron-store blob. All paths respect XDG base dirs and Electron `app.getPath()`. ## Built-in design skill library @@ -100,7 +100,7 @@ Four tabs in the desktop Settings: - No bundled model runtimes (no Ollama binary, no Python, no browser binary shipped) - BYOK only — no proxied API calls, no cloud account, no telemetry by default -- Local-first storage — all user data stays on disk +- Local-first storage — all user data stays on disk; v0.2 uses JSONL sessions plus workspace files instead of new SQLite-backed design state - MIT-compatible permissive dependencies only (no GPL/AGPL/SSPL/proprietary) - Lazy-load heavy features (PPTX export, PDF export, web capture, codebase scan) on first use - Schema-version everything that lives on disk (config files, SQLite tables, IPC payloads, exported bundles) @@ -112,12 +112,14 @@ Claude Design exposes three structural problems: 2. Single-model ceiling (Anthropic Opus only; no competition, no cost control, no way to try a cheaper model for rough drafts) 3. Cloud data processing with no meaningful export/import (no version history, no Figma round-trip, no codebase awareness) -open-codesign addresses all three: BYOK eliminates lock-in, multi-model support enables cost optimization, and local SQLite storage gives the user complete control of their design history. +open-codesign addresses all three: BYOK eliminates lock-in, multi-model support enables cost optimization, and local-first storage gives the user control of their design history. v0.1 uses SQLite snapshots; v0.2 moves sessions to JSONL and design files to user workspaces. ## Roadmap - **v0.1 (shipped, April 2026)** — unsigned installers, multi-provider BYOK, 15 demos, 12 skills, HTML/JSX/PDF/PPTX/ZIP/Markdown export, inline comment, sliders, preview pool, per-generation token counter. -- **v0.2** — pre-generation token estimate + weekly spend budget, version snapshots with diff + rollback, three-style parallel exploration. +- **v0.1.4 (shipped, April 2026)** — AI image generation, ChatGPT Plus / Codex subscription login, CLIProxyAPI import, and third-party relay reliability. +- **v0.2 (Agentic Design, expected in about one week)** — pi sessions with JSONL history, real workspace files, permissioned pi tools, design-specific tools (`ask`, `scaffold`, `skill`, `preview`, `gen_image`, `tweaks`, `todos`, `done`), DESIGN.md design-system artifacts, and v0.1 migration. +- **v0.2.x** — renderer polish for `ask`, `preview`, tweaks, process-management surfaces, E2E coverage, and broader migration fixtures. - **v0.3** — codebase → design system token extraction (Tailwind / CSS vars / W3C DTCG extractors are implemented library-side; v0.3 wires them to the desktop UI). - **v0.4** — on-demand Playwright web capture, handoff bundle to open-cowork, external skill packs. - **v0.5** — Apple Developer ID + Windows Authenticode code-signing, opt-in auto-update, Homebrew Cask + winget + Scoop manifests verified. diff --git a/website/public/llms.txt b/website/public/llms.txt index 71b43225..49e380ae 100644 --- a/website/public/llms.txt +++ b/website/public/llms.txt @@ -14,14 +14,14 @@ - Repository: https://github.com/OpenCoworkAI/open-codesign - Website: https://opencoworkai.github.io/open-codesign/ - License: MIT -- Latest release: v0.1.3 (2026-04-21); v0.1.4 in preparation (AI image generation, ChatGPT Plus / Codex subscription support, CLIProxyAPI one-click import, API reliability polish) +- Latest release: v0.1.4 (2026-04-23): AI image generation, ChatGPT Plus / Codex subscription support, CLIProxyAPI one-click import, and API reliability polish - GitHub stars: 1,500+ as of 2026-04-23 - Downloads to date: 1,700+ installers across macOS / Windows / Linux - Contributors: 8+ - Community: GitHub Discussions, LINUX DO (Chinese-speaking primary community), WeChat group - Stack: Electron, React 19, Vite 6, TypeScript, Tailwind v4, better-sqlite3, Zustand -- Agent runtime: `@mariozechner/pi-agent-core` with a virtual-filesystem tool surface -- Local-first: SQLite (design history) + TOML config (via `~/.config/open-codesign/config.toml`, mode 0600 — matching Claude Code / Codex / gh CLI conventions). Nothing leaves the machine. +- Agent runtime: v0.1 uses `@mariozechner/pi-agent-core`; v0.2 moves the main loop to `pi-coding-agent` and `pi-ai` primitives. +- Local-first: v0.1 uses SQLite for design history and TOML config via `~/.config/open-codesign/config.toml` (mode 0600). v0.2 migrates designs into JSONL sessions plus real workspace files. Nothing leaves the machine. - BYOK: no API proxying, no per-token surcharges, no cloud account required, no telemetry by default. - Supported providers: Anthropic Claude, OpenAI GPT, Google Gemini, DeepSeek, OpenRouter, SiliconFlow, Kimi, GLM, Qwen, Ollama, any OpenAI-compatible endpoint. Keyless (IP-allowlisted) proxies and ChatGPT Plus / Codex subscriptions both supported. - Platforms: macOS (Apple Silicon + Intel), Windows (x64 + arm64), Linux (AppImage, .deb, .rpm). @@ -64,26 +64,25 @@ - Four-tab Settings: Models, Appearance, Storage, Diagnostics, Advanced - Release pipeline with unsigned DMG / EXE / AppImage (code-signing lands in v0.5) -## Coming in v0.2 — the Agentic Design Loop +## Coming in v0.2 — Agentic Design -v0.2 is an architectural upgrade, not a feature list. It turns Open CoDesign from a one-shot generator into a persistent agentic design workspace. +v0.2 is in preparation and expected in about one week. It turns Open CoDesign from a one-shot generator into a local design agent with a real workspace. -- Per-project workspace — bind any folder on disk; all generated files live there, usable with git, shareable -- Agent reads your workspace — new `read_file`, `list_files`, `grep`, `find` tools so the agent understands context before generating -- Agent edits real files — str-replace style targeted edits plus full-file writes, with opt-in permission UX -- Path sandbox + permission model — opencode-style `allow / deny / ask / always` ruleset; `.env` and credentials blocked by default -- Point-and-prompt revision — click any region in the live preview, describe the change, the agent edits just that region (no full-page regeneration) -- Visual verification — the agent can screenshot its own preview to verify what it built -- Progressive skill disclosure — skills become tool-invoked resources instead of always-injected prompt text (≥30% token reduction expected per turn) -- Streaming tag-dispatch parser — files start writing to disk before the LLM finishes streaming, for immediate user feedback -- Snapshot-per-turn with rollback — never lose a good iteration +- Design as session — every design is a pi session with JSONL history and a workspace folder on disk +- Permissioned local tools — pi built-ins for read, write, edit, bash, grep, find, and ls, gated by Open CoDesign's permission UI +- Design tools on demand — `ask`, `scaffold`, `skill`, `preview`, `gen_image`, `tweaks`, `todos`, and `done` +- Preview self-checks — console errors, asset errors, DOM outline, metrics, and screenshots when the model supports vision +- Progressive skill disclosure — skills, scaffolds, and brand references lazy-load from manifests with source and license metadata +- DESIGN.md as design-system memory — brand values and tokens live in editable files, not model memory +- v0.1 migration path — existing SQLite designs migrate into workspaces and session history -Design doc: `docs/plans/2026-04-23-v0.2-agentic-design-loop-design.md` in the repo. +Plan source: `docs/v0.2-plan.md` in the repo. -## Coming later (v0.3 — v0.5) +## Coming later (v0.2.x — v0.5) +- v0.2.x renderer polish for `ask`, `preview`, tweaks, and process-management surfaces - Cost transparency — pre-generation token estimate + weekly spend budget -- Version snapshots + side-by-side diff + rollback across turns +- Version history improvements + side-by-side diff - Three-style parallel exploration - Codebase → design system (extract Tailwind tokens, CSS variables, W3C design tokens from a local repo) - Web capture via Playwright (on-demand) @@ -120,7 +119,7 @@ Q: Can I log in with my ChatGPT Plus subscription instead of an API key? A: Yes. Open CoDesign supports ChatGPT Plus / Codex OAuth subscription login — a one-click flow, no API key required. Q: Does Open CoDesign send my prompts or designs to any third party? -A: No. All designs, prompts, and codebase scans live on your machine (SQLite for history + TOML config at `~/.config/open-codesign/config.toml`, file mode 0600). The only outbound network traffic is directly to the model provider you configure with your own API key. +A: No. Designs, prompts, and scans live on your machine. v0.1 uses SQLite for history plus TOML config at `~/.config/open-codesign/config.toml` (file mode 0600); v0.2 migrates designs into JSONL sessions and workspace files. The only outbound network traffic is directly to the model provider you configure with your own API key. Q: Which AI models does Open CoDesign support? A: Anthropic Claude, OpenAI GPT, Google Gemini, DeepSeek, OpenRouter, SiliconFlow, Kimi, GLM, Qwen, local Ollama, and any OpenAI-compatible endpoint. Keyless (IP-allowlisted) corporate proxies and ChatGPT Plus / Codex subscriptions are also supported. @@ -146,7 +145,7 @@ Open CoDesign differs from Claude Design in the following ways: - Open CoDesign runs entirely on the user's machine; Claude Design processes data in the cloud. - Open CoDesign costs only the token usage of the user's own API key; Claude Design requires a paid subscription. - Open CoDesign is a desktop application (Electron); Claude Design is a web application. -- Open CoDesign stores all designs locally in SQLite with full version history; Claude Design has limited export and no import. +- Open CoDesign stores designs locally. v0.1 uses SQLite snapshots; v0.2 migrates designs into JSONL sessions plus real workspace files. Claude Design has limited export and no import. - Open CoDesign ships twelve built-in design skill modules and fifteen ready-to-edit demo prompts; Claude Design is a blank canvas. - Open CoDesign reuses your existing Claude Code or Codex config in one click; Claude Design has no config-import path. diff --git a/website/roadmap.md b/website/roadmap.md index 70211136..9e08a4d1 100644 --- a/website/roadmap.md +++ b/website/roadmap.md @@ -5,7 +5,7 @@ description: What ships when. Living document, tracked alongside the code. # Roadmap -Living plan from v0.1 → v1.0. Phases are cumulative — each stage builds on the last. +Living plan from v0.1 → v1.0. Phases are cumulative; each stage builds on the last. ## v0.1 — Shipped (April 2026) @@ -22,13 +22,37 @@ First public release, installers for macOS (DMG), Windows (EXE), and Linux (AppI - Bilingual UI (English + 简体中文) - Built-in anti-AI-slop design Skill -## v0.2 — Cost + versions (next) +## v0.1.4 — Shipped (April 2026) -Pre-generation token estimate and weekly spend budget (per-generation token counter already ships in the sidebar), version snapshots with side-by-side diff and rollback, three-style parallel exploration. +Reliability and provider-access release. + +- AI image generation for opt-in bitmap assets +- ChatGPT Plus / Codex subscription login through OAuth, no API key required +- CLIProxyAPI auto-detect and one-click import +- Clearer diagnostics for third-party relay timeouts, SSE truncation, missing `/models`, and incompatible Messages APIs + +## v0.2 — Agentic Design (next) + +Expected in about one week. v0.2 changes the core loop from one-shot prompt-to-artifact generation into a local design agent with real files. + +- Every design is a pi session with JSONL history and a workspace folder +- The agent uses pi built-ins for read, write, edit, bash, grep, find, and ls, gated by Open CoDesign's permission UI +- Design-specific tools cover `ask`, `scaffold`, `skill`, `preview`, `gen_image`, `tweaks`, `todos`, and `done` +- `DESIGN.md` becomes a shared design-system artifact that users and the agent can both edit +- v0.1 SQLite designs migrate into workspace files and session history +- Skills, scaffolds, and brand references lazy-load from manifests with source and license metadata + +## v0.2.x — Agentic surface polish + +The first follow-up track is renderer depth around the new agent loop. + +- Finish and harden the `ask`, `preview`, tweaks, and process-management surfaces +- Add broader Playwright coverage for New Design → ask → scaffold → write → preview → tweaks → done +- Expand v0.1 migration fixtures for edge cases ## v0.3 — Codebase → design system -Point at a local repo; we extract Tailwind tokens, CSS variables, and W3C design tokens, and every subsequent generation respects them. The extractors (`tailwindExtractor`, `cssVarExtractor`, `dtcgImporter`) are already implemented library-side with full test coverage; v0.3 wires them to the desktop UI. +Point at a local repo; Open CoDesign extracts Tailwind tokens, CSS variables, and W3C design tokens so later generations follow the same system. The extractors (`tailwindExtractor`, `cssVarExtractor`, `dtcgImporter`) are already implemented library-side with test coverage; v0.3 wires them deeper into the desktop UI. ## v0.4 — Web capture + handoff @@ -44,9 +68,8 @@ Onboarding ≤ 3 steps, full bilingual docs, stable public API for packages/core ## Deferred (post-1.0) -Real-time collaboration, MCP server interface, Claude Artifacts `` import, plugin loading inside open-cowork, hosted demo site, mobile companion (read-only). +Real-time collaboration, MCP server interface, Claude Artifacts `` import, plugin loading inside open-cowork, hosted demo site, mobile companion (read-only), session branching UI, undo/version rollback. ## Anti-goals Built-in payment, user accounts, cloud sync, stock asset library, custom model fine-tuning, team admin console. - diff --git a/website/zh/faq.md b/website/zh/faq.md index a358071d..1e68113b 100644 --- a/website/zh/faq.md +++ b/website/zh/faq.md @@ -63,7 +63,7 @@ Bolt.new 是基于浏览器的全栈应用构建器,跑在 StackBlitz 的 WebC ## Open CoDesign 会把我的提示词或设计发给第三方吗? -不会。所有设计、提示词、快照、代码库扫描结果都存在你本机——SQLite 存设计历史,TOML 配置文件存在 `~/.config/open-codesign/config.toml`,文件权限 0600(和 Claude Code / Codex / gh CLI 同等级)。唯一的对外网络流量就是直接发给你配置的模型提供商,用的是你自己的 API Key。默认零遥测。 +不会。设计、提示词和扫描结果都存在你本机。v0.1 用 SQLite 存设计历史,TOML 配置文件在 `~/.config/open-codesign/config.toml`,文件权限 0600;v0.2 会把设计迁到 JSONL session 和工作区文件。唯一的对外网络流量就是直接发给你配置的模型提供商,用的是你自己的 API Key。默认零遥测。 ## Open CoDesign 支持哪些 AI 模型? @@ -123,17 +123,17 @@ scoop install open-codesign ## v0.2 会带来什么? -v0.2 是架构升级——"Agentic Design Loop"。从一次性的提示词转产物生成器,升级为: +v0.2 是 Agentic Design 大更新,预计一周左右发布。它会把 Open CoDesign 从一次性的提示词转产物生成器,升级成一个本地设计 agent: -- **每个项目一个工作区**——绑定磁盘上任意目录,所有生成的文件都在那里,可直接配合 git 使用 -- **Agent 读取你的工作区**——`read_file`、`list_files`、`grep`、`find` 等工具,让 agent 在生成前理解上下文 -- **Agent 编辑真实文件**——str-replace 风格的精准编辑加全文件写入,带可选权限确认 UX -- **指点修改**——点击预览中的任意区域,描述改动,agent 只改那块 -- **视觉验证**——agent 可以截图自己的预览,验证它写出来的东西 -- **渐进式技能加载**——设计技能从一直注入提示词改为按需被 agent 工具调用 -- **每轮快照回滚**——再不会丢失某次满意的迭代结果 +- **带真实工作区的 design**——每个 design 都是一个 pi session,历史写入 JSONL,产物落在磁盘文件里 +- **带权限的本地工具**——read、write、edit、bash、grep、find、ls 都会经过 Open CoDesign 的权限 UI +- **设计专用工具**——`ask`、`scaffold`、`skill`、`preview`、`gen_image`、`tweaks`、`todos`、`done` +- **预览自检**——agent 可以渲染产物,检查 console / asset 错误;模型支持视觉时还能看截图 +- **渐进式技能加载**——skill、scaffold、brand reference 按需加载,而不是全部塞进基础提示词 +- **`DESIGN.md` 作为设计系统记忆**——品牌值和 token 写进可编辑文件,而不是靠模型记忆 +- **v0.1 迁移路径**——旧 SQLite 设计会迁移到真实工作区和 session history -完整设计文档已公开,社区评审中。里程碑计划见 [roadmap](/roadmap)。 +里程碑计划见 [roadmap](/roadmap)。 ## Open CoDesign 安全吗? diff --git a/website/zh/index.md b/website/zh/index.md index 3e895912..7ac687e4 100644 --- a/website/zh/index.md +++ b/website/zh/index.md @@ -7,7 +7,7 @@ description: Open CoDesign 是一款开源桌面 AI 设计工具,Claude Design hero: name: Open CoDesign text: 用心设计。 - tagline: 开源桌面 AI 设计工具。自带模型、本地运行——Claude Design 的自托管替代方案,给无法接受订阅锁定的团队。 + tagline: 开源桌面 AI 设计工具。v0.1.4 已发布;v0.2.0 正在准备 Agentic Design 大更新,会带来真实工作区和带权限的本地工具循环。 image: src: /logo-hero.png alt: Open CoDesign — 开源 AI 设计工具 @@ -31,7 +31,7 @@ features: details: 已经在用 Claude Code 或 Codex?Open CoDesign 直接读你的配置文件——provider、model、API Key,一次带过来。 - icon: 🏡 title: 你的电脑就是云 - details: 设计稿、提示词、代码库扫描——SQLite 加密 TOML,全在本地磁盘。无需注册账号,默认无遥测。100% 本地。 + details: 设计稿、提示词和设置都在本地磁盘。v0.1 用 SQLite 保存设计历史;v0.2 会迁到 JSONL session 加真实工作区文件。无需注册账号,默认无遥测。 - icon: 🪄 title: 12 个设计 Skill 开箱即用 details: 内置 12 个设计 skill 模块——仪表盘、落地页、幻灯片、定价页、聊天 UI、数据表格、日历、玻璃质感、编辑排版等等。在任何项目添加你自己的 SKILL.md,教会模型你的审美。 @@ -43,16 +43,16 @@ features: details: 预览中点击任意元素落一枚 pin,留下注释,模型只重写该区域。不用为了挪一个按钮重新提示整个页面。 - icon: 🔀 title: 设计间切换瞬答 - details: 最近 5 个 design 之间切换零延迟。预览 iframe 常驻内存——不重新解析、没白闪、不用等快照重载。 + details: 最近 5 个 design 之间切换零延迟。预览 iframe 常驻内存,不重新解析、没白闪,也不用等待重载。 - icon: 📱 title: 桌面、平板、手机 details: 任一设计都能在真实手机框或平板宽度里预览,与完整画布并排查看。导出前先看响应式故事。 - icon: 🧬 - title: 代码库 → 设计系统 - details: 指向本地仓库,我们抽取 Tailwind token、CSS 变量和 W3C 设计 token——之后每次生成都自动遵循。即将推出。 + title: v0.2:Agentic Design + details: 每个 design 都会变成长程 session,并绑定真实工作区。Agent 可以读写文件、运行带权限的工具、预览自检,并把设计系统决策写进文件。 - icon: 📐 - title: 版本、对比、快照 - details: 每一次迭代都是一个快照。并排 diff 两个版本,回滚,分支。这是 Claude Design 没有的历史记录。即将推出。 + title: DESIGN.md 作为设计记忆 + details: 品牌值和设计 token 写进 DESIGN.md,而不是存在模型记忆里。你可以带入自己的设计系统,也可以让 agent 在生成过程中维护它。 - icon: 💸 title: 成本透明 details: 生成前显示 token 估算,工具栏显示本周花费。设置预算,超出前收到提醒,不再有意外账单。即将推出。 @@ -85,7 +85,7 @@ import { withBase } from 'vitepress'
3

打磨、导出、交付

-

元素级评论、AI 滑块、版本时间线。导出 HTML、PDF、PPTX、ZIP 或 Markdown——全部本地生成。

+

元素级评论、AI 滑块、本地文件。导出 HTML、PDF、PPTX、ZIP 或 Markdown——全部本地生成。

@@ -112,7 +112,7 @@ import { withBase } from 'vitepress'
设计主页 — 所有生成过的 artifact -
每次迭代都在。本地 SQLite 快照,最近 5 个零延迟切换。
+
每次迭代都在。设计历史保存在本地;v0.2 会迁到 JSONL session 加真实工作区文件。
内置示例库 — 15 个即可运行的设计命题 @@ -170,7 +170,7 @@ import { withBase } from 'vitepress'

用户交流群(微信)

-

扫码加入中文讨论组。二维码每 7 天刷新,当前截至 4 月 28 日 有效。过期请到 GitHub Issues 留言提醒我们更新。

+

扫码加入中文讨论组。二维码每 7 天刷新,当前截至 5 月 4 日 有效。过期请到 GitHub Issues 留言提醒我们更新。