Track Flue skill and refresh top-level docs

- Commit the vendored Flue SKILL.md under .agents/skills/flue and the
  .claude/skills/flue symlink plus skills-lock.json entry.
- Rewrite AGENTS.md down to the repo's actual conventions and expand
  README.md with daemon/TUI/dev script notes.
This commit is contained in:
-Puter
2026-07-19 17:29:42 +05:30
parent a9a8354346
commit 8cd479f20c
5 changed files with 198 additions and 176 deletions

View File

@@ -11,8 +11,10 @@ This project was created with [Better-T-Stack](https://github.com/AmanVarshney01
- **TailwindCSS** - Utility-first CSS for rapid UI development
- **Shared UI package** - shadcn/ui primitives live in `packages/ui`
- **Convex** - Reactive backend-as-a-service platform
- **Agent daemon** - Bun/Effect service that leases Convex commands and dispatches them to AgentOS/RivetKit actors
- **Authentication** - Better-Auth
- **Electrobun** - Lightweight desktop shell for web frontends
- **OpenTUI** - Terminal interface in `apps/tui`
- **Oxlint** - Oxlint + Oxfmt (linting & formatting)
- **Vite+** - Unified Vite toolchain, workspace task runner, linting, and formatting
@@ -44,6 +46,16 @@ bun run dev
Open [http://localhost:5173](http://localhost:5173) in your browser to see the web application. Use the Expo Go app to run the mobile application. Your app will connect to the Convex cloud backend automatically.
### Daemon setup
The daemon is a separate Bun process that connects to Convex, claims queued `daemonCommands`, and runs AgentOS actor actions. Copy `apps/daemon/.env.example` to `apps/daemon/.env`, replace the placeholder `CONVEX_URL`, then run:
```bash
bun run dev:daemon
```
Build the compiled daemon binary with `bun run build:daemon`; the output is `apps/daemon/dist/code-daemon`.
## UI Customization
React web apps in this stack share shadcn/ui primitives through `packages/ui`.
@@ -81,11 +93,17 @@ If you want to add app-specific blocks instead of shared primitives, run the sha
```
code/
├── apps/
│ ├── web/ # Frontend application (React + React Router)
│ ├── web/ # Web application (React + React Router)
│ ├── native/ # Mobile application (React Native, Expo)
│ ├── desktop/ # Electrobun shell around the web build
│ ├── tui/ # OpenTUI terminal client
│ ├── daemon/ # Bun/Effect daemon for AgentOS command execution
├── packages/
│ ├── ui/ # Shared shadcn/ui components and styles
│ ├── backend/ # Convex backend functions and schema
│ ├── primitives/ # Shared Effect services, including AgentOS helpers
│ ├── env/ # Runtime environment validation
│ ├── ui/ # Shared shadcn/ui components and styles
├── repos/ # Vendored upstream references; excluded from normal tooling
```
## Available Scripts
@@ -93,17 +111,22 @@ code/
- `bun run dev`: Start all applications in development mode
- `bun run build`: Build all applications
- `bun run dev:web`: Start only the web application
- `bun run dev:server`: Start the Convex development server
- `bun run dev:setup`: Setup and configure your Convex project
- `bun run check-types`: Check TypeScript types across all apps
- `bun run dev:native`: Start the React Native/Expo development server
- `bun run dev:tui`: Start the terminal UI
- `bun run check`: Run Vite+ format/lint checks and workspace TypeScript checks
- `bun run lint`: Run Vite+ lint checks
- `bun run format`: Run Vite+ formatting
- `bun run fix`: Apply Ultracite fixes
- `bun run staged`: Run Vite+ checks against staged files
- `bun run hooks:setup`: Install Vite+ native Git hooks with `vp config`
- `bun run dev:desktop`: Start the Electrobun desktop app with HMR
- `bun run build:desktop`: Build the stable Electrobun desktop app
- `bun run build:desktop:canary`: Build the canary Electrobun desktop app
- `bun run dev:daemon`: Start the daemon with Bun watch mode
- `bun run build:daemon`: Compile the daemon binary
- `bun run docs:update [commit-or-range]`: Ask a detected coding-agent CLI to update first-party documentation for a commit or revision range; use `--dry-run` to inspect the prompt
- `bun run subtree list`: List configured vendored Git subtrees
- `bun run subtree status [name]`: Inspect subtree metadata and local dirtiness