Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
40 commits
Select commit Hold shift + click to select a range
b5baec6
feature:Localization update
Aug 30, 2026
759b84a
Rename living UI to agent app
Aug 30, 2026
6382024
Rename sidebar item
Aug 30, 2026
7b58fa1
Improve agent app UI/ux
Aug 31, 2026
ac1b457
reset default language to en
Aug 31, 2026
a2f61e1
fix: long file path issue - windows
ahmad-ajmal Aug 31, 2026
465a688
Create fallback code to handle older agent app manifest version
Sep 1, 2026
fa56854
Merge branch 'V1.4.3' of https://github.com/craftos-dev/craftbot into…
Sep 1, 2026
995e811
fix: better logging for agent app + import in bg proces + UX
ahmad-ajmal Sep 1, 2026
bd2b4df
fix: evolve agent debug logs
ahmad-ajmal Sep 2, 2026
e82cef3
bug:context overflow causing event stream collapsed
zfoong Sep 7, 2026
97ef1ab
set write and edit file action parallelizable to prevent extra wasted…
Sep 7, 2026
5c427b8
make MCP server root configurable and make playwright save their outp…
Sep 7, 2026
fe6bc07
Calculate system prompt and event stream token properly
zfoong Sep 7, 2026
f3c3dd2
scratch pad, session specific event and event unprocessed file, updat…
Sep 7, 2026
3b87745
Merge pull request #445 from CraftOS-dev/fix/context-overflow
zfoong Sep 7, 2026
5c64383
Add per-file locks for write_file and stream_edit
RooberSmoth Sep 8, 2026
6537d48
Merge pull request #447 from CraftOS-dev/file-lock-branch
zfoong Sep 9, 2026
c33522c
Revamp agent app system
Sep 10, 2026
834328c
Large revamp of agent app system
Sep 11, 2026
0c69423
commit file lock module
Sep 11, 2026
fa1d308
small read file action update
Sep 11, 2026
e475267
real-time refresh of agent app operation
Sep 13, 2026
841f801
Standardizing agent app kit
Sep 14, 2026
2f6f36f
fix: save ui state
ahmad-ajmal Sep 15, 2026
25963d8
feat(web-ui): live data freshness and responsiveness revamp
ahmad-ajmal Sep 15, 2026
d1a733c
op smoke operation
Sep 16, 2026
19ca315
Merge branch 'V1.4.3' of https://github.com/craftos-dev/craftbot into…
Sep 16, 2026
6ab27d0
fix: import app not starting
ahmad-ajmal Sep 16, 2026
3e132c8
remove dead reference and fix minor agent app bug
Sep 17, 2026
5bbf0fd
Merge branch 'V1.4.3' of https://github.com/craftos-dev/craftbot into…
Sep 17, 2026
b18f699
fix: gmail metadata + cuncurrent tasks not ending
ahmad-ajmal Sep 17, 2026
9088469
change lui signature to a2app or agent app
Sep 18, 2026
55b993e
Merge branch 'V1.4.3' of https://github.com/craftos-dev/craftbot into…
Sep 18, 2026
4fe9618
fix: playbook nodes
ahmad-ajmal Sep 18, 2026
a421e50
fix: parallel actions
ahmad-ajmal Sep 18, 2026
93d8dc9
update version number
ahmad-ajmal Sep 18, 2026
09d4022
integration: posthog
ahmad-ajmal Sep 20, 2026
59ba4dc
Add SkillUI as default skill and context7 as default MCP
Sep 21, 2026
2447c71
AGENT md update for V1.4.3
Sep 23, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
24 changes: 12 additions & 12 deletions .github/workflows/living-ui.yml → .github/workflows/agent-app.yml
Original file line number Diff line number Diff line change
@@ -1,22 +1,22 @@
name: living-ui
name: agent-app

# Self-test for the Living UI TEMPLATE code (kit/blueprint/tools) in this repo.
# Self-test for the Agent App TEMPLATE code (kit/blueprint/tools) in this repo.
# Scaffolds a throwaway project and runs the local validation gate on it.
# User-made Living UIs never touch this workflow — they validate locally.
# User-made Agent Apps never touch this workflow — they validate locally.

on:
push:
paths:
- 'living-ui/**'
- '.github/workflows/living-ui.yml'
- 'agent-app/**'
- '.github/workflows/agent-app.yml'
pull_request:
paths:
- 'living-ui/**'
- '.github/workflows/living-ui.yml'
- 'agent-app/**'
- '.github/workflows/agent-app.yml'

defaults:
run:
working-directory: living-ui
working-directory: agent-app

jobs:
gate:
Expand All @@ -37,10 +37,10 @@ jobs:
uses: actions/cache@v4
with:
path: |
~/Library/Caches/craftos-living-ui/pb
~/.cache/craftos-living-ui/pb
~\AppData\Local\craftos-living-ui\pb
key: pb-${{ runner.os }}-${{ hashFiles('living-ui/spec/pocketbase.version') }}
~/Library/Caches/craftos-agent-app/pb
~/.cache/craftos-agent-app/pb
~\AppData\Local\craftos-agent-app\pb
key: pb-${{ runner.os }}-${{ hashFiles('agent-app/spec/pocketbase.version') }}

- name: Install workspace
run: npm install
Expand Down
4 changes: 2 additions & 2 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -54,11 +54,11 @@ agent_file_system/TASK_HISTORY.md
**/onboarding_config.json
**/config.json
!build_template.py
docs/LIVING_UI_DEVELOPER_GUIDE.md
docs/AGENT_APP_DEVELOPER_GUIDE.md
agent_file_system/ACTIONS.md
agent_bundle/
**/.craftbot/
app/data/.file_index/
.playwright-mcp
# Sidecar Node runtime (install.py downloads it when the system Node is too old for Living UI)
# Sidecar Node runtime (install.py downloads it when the system Node is too old for Agent App)
runtime/
2 changes: 1 addition & 1 deletion .ruff.toml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
extend-exclude = [
"app/data/living_ui_template",
"app/data/agent_app_template",
]

# Pin the rule set explicitly. The repo was linted against ruff's classic
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,7 @@ python -m compileall -q app agent_core agents decorators skills
### About `.ruff.toml`

The repo ships a [`.ruff.toml`](.ruff.toml) that:
- **Excludes** `app/data/living_ui_template/` — that directory contains Jinja templates with `{{placeholders}}`, not valid Python.
- **Excludes** `app/data/agent_app_template/` — that directory contains Jinja templates with `{{placeholders}}`, not valid Python.
- **Ignores E402 per-file** for a small set of files (logging setup, asyncio shims, registry init) where import ordering is deliberate.

**Do not** add new entries casually. If you hit E402 in a new file, prefer moving the import; only add the file to the ignore list if the ordering is genuinely load-bearing, and explain why in your commit.
Expand Down
32 changes: 16 additions & 16 deletions README.cn.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@

- **Agent 配置档案** 40+ Agent 配置档案(CEO Agent、财务 Agent、市场负责人 Agent、DevOps 工程师、视频制作 Agent 等共 37 种)随时为你服务。从 **[CraftBot Agent Bundles](https://github.com/CraftOS-dev/craftbot-agent-bundles)** 找到所需角色,一键导入。
- **Playbook 目录** 不知道如何用 AI Agent 自动化?CraftBot 内置 120 个 Playbook(覆盖 19 个分类)随时可用。从顶部栏打开 Playbook 选择器,挑选一个 Playbook,它就会开始为你执行任务。
- **Living UI.** 在 CraftBot 内部构建、导入或演进自定义应用。Agent 始终感知 UI 状态,并能直接读取、写入和操作其中的数据。
- **Agent App.** 在 CraftBot 内部构建、导入或演进自定义应用。Agent 始终感知 UI 状态,并能直接读取、写入和操作其中的数据。
- **多任务与会话路由.** 还在手动敲 `/new` 吗?CraftBot 能自行判断何时开启新会话、何时继续旧任务,让对话与上下文保持统一。
- **自托管与 BYOK.** 灵活的 LLM 提供商体系,支持 OpenAI、Google Gemini、Anthropic Claude、OpenRouter 等。也可以用 Ollama 自行托管模型,实现零 Token 消耗。
- **记忆系统.** 从你与 CraftBot 的交互中构建的第二大脑。混合方案:RAG + 知识图谱 + Agent 文件系统。CraftBot 会在午夜「做梦」,整合一整天发生的事件。
Expand Down Expand Up @@ -85,65 +85,65 @@ python craftbot.py uninstall # 停止运行、移除自启动并卸载所有依

---

## 🌱 Living UI
## 🌱 Agent App

**Living UI 是会随你的需求一同演进的系统/应用/仪表盘。**
**Agent App 是会随你的需求一同演进的系统/应用/仪表盘。**

<div align="center">
<img src="assets/living_ui_banner.gif" alt="CraftBot Banner" width="1280"/>
<img src="assets/agent_app_banner.gif" alt="CraftBot Banner" width="1280"/>
</div>

- 想要一个内置 AI 协作伙伴的看板?
- 一套完全贴合你工作流的定制 CRM?
- 一个 CraftBot 能替你读取并操作的公司仪表盘?

将它作为 Living UI 启动:它与 CraftBot 并行运行,并随着你的需求变化而成长。
将它作为 Agent App 启动:它与 CraftBot 并行运行,并随着你的需求变化而成长。

### 创建 Living UI 的三种方式
### 创建 Agent App 的三种方式

1. **从零构建.** 用自然语言描述你想要的东西,CraftBot
会搭好数据模型、后端 API 和 React 前端,
并通过一套结构化的设计流程与你不断迭代。

<div align="center">
<img src="assets/living-ui-custom-build.png" alt="Building a Living UI from scratch" width="448"/>
<img src="assets/agent-app-custom-build.png" alt="Building a Agent App from scratch" width="448"/>
</div>

2. **从市场安装.** 在 [living-ui-marketplace](https://github.com/CraftOS-dev/living-ui-marketplace) 中浏览社区构建的 Living UI。
2. **从市场安装.** 在 [living-ui-marketplace](https://github.com/CraftOS-dev/living-ui-marketplace) 中浏览社区构建的 Agent App。

<div align="center">
<img src="assets/living-ui-marketplace.png" alt="Living UI marketplace" width="448"/>
<img src="assets/living-ui-marketplace.png" alt="Agent App marketplace" width="448"/>
</div>

3. **导入现有项目.** 把 Go、Node.js、Python、Rust
或者静态源码、GitHub 仓库交给 CraftBot,它会自动识别运行时、配置健康检查,并把它封装成一个 Living UI。
或者静态源码、GitHub 仓库交给 CraftBot,它会自动识别运行时、配置健康检查,并把它封装成一个 Agent App。

<div align="center">
<img src="assets/living-ui-import.png" alt="Importing an existing project as a Living UI" width="448"/>
<img src="assets/agent-app-import.png" alt="Importing an existing project as a Agent App" width="448"/>
</div>

### 让 CraftBot 持续参与的不断演进

Living UI 永远没有「完成」这一说。需求一变,就让 Agent 给它加功能、
Agent App 永远没有「完成」这一说。需求一变,就让 Agent 给它加功能、
改版页面或接入新数据源。

CraftBot 嵌入在每个 Living UI 之中,并且**对其状态保持感知**:
CraftBot 嵌入在每个 Agent App 之中,并且**对其状态保持感知**:
它可以读取当前 DOM 和表单值、通过 REST API 查询应用数据,
并代替你触发操作。

### 让 SaaS 工具保持开放与鲜活

构建、定制并不断演进属于自己的 Living UI,减少对那些从未真正为你量身定制的订阅工具的依赖。
构建、定制并不断演进属于自己的 Agent App,减少对那些从未真正为你量身定制的订阅工具的依赖。

---

# 三个 5 分钟内可以试玩的 Living UI
# 三个 5 分钟内可以试玩的 Agent App

- **📋 看板**:把所有任务、跟进事项和待办集中到一个地方,CraftBot 可以接手运营,替你完成 PM 工作。
- **📊 习惯追踪器**:培养并追踪自己的习惯,用类 GitHub 风格的活动日历像开发者一样维护你的习惯。
- **🐦 Luolinglo**:不是多邻国,但你可以学习新语言、制作单词卡片,并和 CraftBot 一起练习。

**[浏览 Living UI 市场并参与贡献 →](https://craftos.net/marketplace)**
**[浏览 Agent App 市场并参与贡献 →](https://craftos.net/marketplace)**

---

Expand Down
32 changes: 16 additions & 16 deletions README.de.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Darüber hinaus bringt CraftBot alle Kernfunktionen eines universellen Agent-Fra

- **Agent-Profile** Mehr als 40 Agent-Profile (CEO-Agent, Finance-Agent, Marketing-Lead-Agent, DevOps-Engineer, Video-Producer-Agent oder 37 weitere) stehen bereit, um für dich zu arbeiten. Finde die gewünschten Rollen in den **[CraftBot Agent Bundles](https://github.com/CraftOS-dev/craftbot-agent-bundles)** und importiere sie mit einem Klick.
- **Playbook-Katalog** Du weißt nicht, wie du mit einem KI-Agenten automatisieren sollst? CraftBot bringt 120 sofort einsatzbereite Playbooks mit (in 19 Kategorien). Öffne den Playbook-Picker in der oberen Leiste, wähle ein Playbook aus, und es beginnt, die Aufgabe für dich auszuführen.
- **Living UI.** Baue, importiere oder entwickle eigene Apps, die innerhalb von CraftBot leben. Der Agent kennt den Zustand der UI jederzeit und kann ihre Daten direkt lesen, schreiben und damit arbeiten.
- **Agent App.** Baue, importiere oder entwickle eigene Apps, die innerhalb von CraftBot leben. Der Agent kennt den Zustand der UI jederzeit und kann ihre Daten direkt lesen, schreiben und damit arbeiten.
- **Multitasking und Session-Routing.** Tippst du noch von Hand `/new`? CraftBot weiß selbst, wann eine neue Session sinnvoll ist und wann eine bestehende Aufgabe wieder aufgenommen werden sollte, so bleiben Gespräch und Kontext einheitlich.
- **Self-hosted und BYOK.** Flexibles LLM-Provider-System mit Unterstützung für OpenAI, Google Gemini, Anthropic Claude, OpenRouter und mehr. Oder hoste mit Ollama dein eigenes Modell, ganz ohne Token-Verbrauch.
- **Memory-System.** Ein zweites Gehirn, aufgebaut aus deinen Interaktionen mit CraftBot. Hybrider Ansatz: RAG + Wissensgraph + Agent-Dateisystem. Um Mitternacht „träumt" CraftBot und konsolidiert die Ereignisse des Tages.
Expand Down Expand Up @@ -85,65 +85,65 @@ python craftbot.py uninstall # Stoppen, Autostart entfernen und Pakete deinstal

---

## 🌱 Living UI
## 🌱 Agent App

**Living UI ist ein System/App/Dashboard, das mit deinen Anforderungen wächst.**
**Agent App ist ein System/App/Dashboard, das mit deinen Anforderungen wächst.**

<div align="center">
<img src="assets/living_ui_banner.gif" alt="CraftBot Banner" width="1280"/>
<img src="assets/agent_app_banner.gif" alt="CraftBot Banner" width="1280"/>
</div>

- Brauchst du ein Kanban-Board mit eingebautem KI-Copiloten?
- Ein maßgeschneidertes CRM, das exakt deinem Workflow folgt?
- Ein Unternehmens-Dashboard, das CraftBot lesen und für dich bedienen kann?

Bring es als Living UI an den Start: Es läuft neben CraftBot und wächst mit deinen Anforderungen.
Bring es als Agent App an den Start: Es läuft neben CraftBot und wächst mit deinen Anforderungen.

### Drei Wege, eine Living UI zu erstellen
### Drei Wege, eine Agent App zu erstellen

1. **Von Grund auf bauen.** Beschreibe in natürlicher Sprache, was du brauchst. CraftBot
erstellt das Gerüst für Datenmodell, Backend-API und React-UI und iteriert mit dir
über einen strukturierten Designprozess.

<div align="center">
<img src="assets/living-ui-custom-build.png" alt="Building a Living UI from scratch" width="448"/>
<img src="assets/agent-app-custom-build.png" alt="Building a Agent App from scratch" width="448"/>
</div>

2. **Aus dem Marketplace installieren.** Stöbere in von der Community gebauten Living UIs auf [living-ui-marketplace](https://github.com/CraftOS-dev/living-ui-marketplace).
2. **Aus dem Marketplace installieren.** Stöbere in von der Community gebauten Agent Apps auf [living-ui-marketplace](https://github.com/CraftOS-dev/living-ui-marketplace).

<div align="center">
<img src="assets/living-ui-marketplace.png" alt="Living UI marketplace" width="448"/>
<img src="assets/living-ui-marketplace.png" alt="Agent App marketplace" width="448"/>
</div>

3. **Ein bestehendes Projekt importieren.** Verweise CraftBot auf ein Projekt in Go, Node.js, Python,
Rust oder auf statischen Quellcode bzw. ein GitHub-Repo. Er erkennt die Runtime, konfiguriert die Health Checks und verpackt das Ganze als Living UI.
Rust oder auf statischen Quellcode bzw. ein GitHub-Repo. Er erkennt die Runtime, konfiguriert die Health Checks und verpackt das Ganze als Agent App.

<div align="center">
<img src="assets/living-ui-import.png" alt="Importing an existing project as a Living UI" width="448"/>
<img src="assets/agent-app-import.png" alt="Importing an existing project as a Agent App" width="448"/>
</div>

### Entwickelt sich weiter, mit CraftBot mittendrin

Eine Living UI ist nie „fertig". Bitte den Agent, Funktionen zu ergänzen,
Eine Agent App ist nie „fertig". Bitte den Agent, Funktionen zu ergänzen,
eine Ansicht neu zu gestalten oder sie an neue Daten anzubinden, wenn sich deine Anforderungen ändern.

CraftBot ist in jede Living UI eingebettet und **kennt deren Zustand**:
CraftBot ist in jede Agent App eingebettet und **kennt deren Zustand**:
Er kann das aktuelle DOM und Formularwerte lesen, App-Daten über die REST-API
abfragen und in deinem Namen Aktionen auslösen.

### Hält SaaS-Tools offen und lebendig

Baue, passe an und entwickle deine eigene Living UI weiter und reduziere deine Abhängigkeit von Abo-Tools, die nie wirklich für dich gemacht waren.
Baue, passe an und entwickle deine eigene Agent App weiter und reduziere deine Abhängigkeit von Abo-Tools, die nie wirklich für dich gemacht waren.

---

# Drei Living UIs, die du in 5 Minuten ausprobieren kannst
# Drei Agent Apps, die du in 5 Minuten ausprobieren kannst

- **📋 Kanban-Board:** Alle Aufgaben, Follow-ups und CTAs an einem Ort. CraftBot kann es bedienen und die PM-Arbeit für dich übernehmen.
- **📊 Habit Tracker:** Baue deine Gewohnheiten auf und verfolge sie. Ein Aktivitätskalender im GitHub-Stil hilft dir, deine Gewohnheiten wie ein:e Entwickler:in zu pflegen.
- **🐦 Luolinglo:** Kein Duolingo, aber damit kannst du neue Sprachen lernen, Karteikarten erstellen und mit CraftBot üben.

**[Stöbere im Living-UI-Marketplace und trage etwas bei →](https://craftos.net/marketplace)**
**[Stöbere im Agent-App-Marketplace und trage etwas bei →](https://craftos.net/marketplace)**

---

Expand Down
Loading
Loading