Terminal User Interface for Flocks project.

tui/
├── flocks/            # Flocks TUI core source code
│   ├── cli/cmd/tui/  # TUI main code
│   ├── provider/     # AI Provider
│   ├── tool/         # Tools
│   ├── lsp/          # LSP
│   └── ...           # Other modules
├── sdk/               # SDK client
├── util/              # Utility functions
├── src/               # TUI entry point
│   └── index.ts       # Main entry file
├── package.json       # Dependency configuration
├── tsconfig.json      # TypeScript configuration
├── bunfig.toml        # Bun runtime configuration (important!)
└── node_modules/      # Installed dependencies

This is the most important configuration file, telling Bun how to preload SolidJS JSX transformer:

preload = ["@opentui/solid/preload"]

Without this file, Bun cannot properly handle JSX syntax and will throw an error:

Export named 'jsxDEV' not found in module

Configures path aliases for cleaner import paths:

{
  "paths": {
    "@/*": ["./flocks/*"],
    "@tui/*": ["./flocks/cli/cmd/tui/*"],
    "@flocks-ai/sdk/v2": ["./sdk/v2/index.ts"]
  }
}

# In tui directory
cd tui
bun install

# Connect to running server
bun run --conditions=browser ./src/index.ts attach http://localhost:8000

# Automatically start backend and frontend
flocks tui

# Specify project directory
flocks tui -d /path/to/project

# Specify port
flocks tui -p 8080

# Continue existing session
flocks tui -s <session-id>

The flocks tui command will:

1. Start Flocks API server in background (default port 8000)
2. Wait for server to be ready
3. Start TUI frontend connecting to server
4. Automatically clean up server process when TUI exits

• Bun: JavaScript/TypeScript runtime
• SolidJS: Reactive UI framework
• OpenTUI: Terminal UI framework
• TypeScript: Type safety

Key dependencies:

• solid-js: 1.9.10
• @opentui/core: 0.1.74
• @opentui/solid: 0.1.74
• zod: 4.1.8
• etc...

If you encounter Export named 'jsxDEV' not found error, ensure:

1. bunfig.toml file exists
2. @opentui/solid package is correctly installed

# Clean and reinstall
rm -rf node_modules bun.lockb
bun install

Ensure compatible Bun version is used:

bun --version  # Should be 1.3.5 or higher

1. Directory rename: flocks/ → flocks/
2. flocks/cli/cmd/tui/routes/session/index.tsx - Fixed import path for parsers-config.ts
3. flocks/cli/cmd/tui/component/logo.tsx - Updated to Flocks Logo
4. flocks/cli/ui.ts - Updated CLI Logo
5. src/index.ts - Custom entry file with simplified CLI commands
6. Configuration path: .flocks/ → .flocks/
7. Theme: flocks.json → flocks.json

• OpenTUI framework: https://github.com/anomalyco/opentui