### Build and Start Backend in Repository

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/gybackend-usage.md

Use these commands to build and start the GyBackend from the repository root. These are the primary commands for contributors working within the development environment.

```bash
npm run build:backend
npm run start:backend
```

--------------------------------

### Build and Start GyBackend

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/gybackend/README.md

Commands to build and start the gybackend workspace using npm. This is typically used for repository development and runtime debugging.

```bash
npm --workspace @gyshell/gybackend run build
npm --workspace @gyshell/gybackend run start
```

--------------------------------

### Clone and Run GyShell Development

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Clone the repository, install dependencies, and start the development server for GyShell.

```bash
git clone https://github.com/MrOrangeJJ/GyShell.git
cd GyShell
npm install
npm run dev
```

--------------------------------

### Build and Start Standalone Mobile-Web Production Preview

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/mobile-web-usage.md

Use these commands to build the mobile-web client for a production-like preview and start the preview server. The preview server is typically available at http://<host-ip>:4174.

```bash
npm run build:mobile-web
npm run start:mobile-web
```

--------------------------------

### Desktop Bundled CLI Usage

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Examples of using the `gyll` CLI with different options and arguments, including specifying a URL and access token.

```bash
gyll --help
gyll --url ip:port
gyll --url ip:port --token <access_token>
gyll --url ip:port "Hello"
gyll --url ip:port --token <access_token> "Hello"
gyll run --url ip:port "Run task"
gyll hook --url ip:port "Send and exit"
```

--------------------------------

### TUI Development

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Command to start the development server for the TUI runtime.

```bash
npm run dev:tui
```

--------------------------------

### Run Mobile Web Development Server

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/mobile-web/README.md

Starts the development server for the mobile-first web frontend. Open the specified URL on your mobile device to access it.

```bash
npm run dev:mobile-web
```

--------------------------------

### First-run CLI Commands

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Basic commands to interact with the GyShell CLI after installation.

```bash
gyll --help
gyll "Plan and execute: run tests, fix failures, and summarize changes"
```

--------------------------------

### GyShell Bundled CLI Help

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/tui/README.md

Display help information for the bundled GyShell CLI tool. This command is available after installing the GyShell desktop app.

```bash
gyll --help
```

--------------------------------

### Gyll CLI Usage

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/build-commands.md

Examples of using the 'gyll' command-line tool to interact with the desktop backend. It supports specifying URLs, messages, and access tokens.

```bash
gyll --help
```

```bash
gyll --url 127.0.0.1:17888
```

```bash
gyll --url 127.0.0.1:17888 "message"
```

```bash
gyll --url 192.168.1.8:17888 --token <access_token>
```

```bash
gyll run --url 127.0.0.1:17888 "message"
```

```bash
gyll hook --url 127.0.0.1:17888 "message"
```

--------------------------------

### Run GyShell TUI in Dev Mode

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/tui/README.md

Start the GyShell TUI in development mode with watch mode enabled. Ensure the GyShell desktop app is running first, as this does not start the backend automatically.

```bash
# Run directly from source with watch mode
npm --workspace @gyshell/tui run dev
```

--------------------------------

### Run GyShell TUI

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/tui/README.md

Execute the GyShell TUI application using npm. This command starts the TUI runtime workspace.

```bash
npm --workspace @gyshell/tui run start
```

--------------------------------

### Standalone Backend Bootstrap Entry

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/monorepo-architecture.md

Specifies the entry point for starting the standalone backend process.

```typescript
packages/backend/src/runtimes/gybackend/startGyBackend.ts
```

--------------------------------

### Basic `gyll` Commands

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/tui-usage.md

These commands cover basic `gyll` operations, including getting help, entering interactive mode, sending messages, running commands, and managing sessions.

```bash
gyll --help
```

```bash
gyll
```

```bash
gyll "Hello"
```

```bash
gyll run "Run tests and summarize"
```

```bash
gyll hook "wake up and continue"
```

```bash
gyll --sessionid "<session-id>"
```

```bash
gyll --url 127.0.0.1:17888
```

```bash
gyll --url 192.168.1.8:17888 --token "<access_token>"
```

--------------------------------

### Terminal Tab Operations

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/monorepo-architecture.md

Examples of terminal tab operations exposed through transport bridges.

```text
terminal:list
terminal:createTab
terminal:kill
```

--------------------------------

### Repo Development Mode Scripts

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/tui-usage.md

These npm scripts are used for developing the TUI component from the repository root. They require the Bun runtime and do not start the backend automatically.

```bash
npm run dev:tui
```

```bash
npm run start:tui
```

--------------------------------

### Execute Build Script

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Runs the main build script. Use --help for options.

```bash
./build.sh --help
```

--------------------------------

### Build Project

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Run this command to build the entire GyShell project.

```bash
npm run build
```

--------------------------------

### Create Windows Distribution

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Builds a distribution package for Windows.

```bash
npm run dist:win
```

--------------------------------

### Prepare CLI Runtime and Mobile Web Assets

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/build-commands.md

Commands to prepare the command-line interface runtime and bundle mobile-web assets for desktop applications. Optional target overrides are available for CLI runtime preparation.

```bash
npm run prepare:cli-runtime
```

```bash
npm run prepare:cli-runtime -- --target darwin-arm64
```

```bash
npm run prepare:cli-runtime -- --target darwin-x64
```

```bash
npm run prepare:cli-runtime -- --target linux-arm64
```

```bash
npm run prepare:cli-runtime -- --target linux-x64
```

```bash
npm run prepare:cli-runtime -- --target windows-x64
```

```bash
npm run prepare:mobile-web
```

--------------------------------

### Build Mobile Web for Production

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/mobile-web/README.md

Builds the mobile-first web frontend for production deployment.

```bash
npm run build:mobile-web
```

--------------------------------

### Create Linux Distribution

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Builds a distribution package for Linux (x64).

```bash
npm run dist:linux
```

--------------------------------

### Desktop Runtime Boot Flow - Main Entry

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/monorepo-architecture.md

The entry point for the desktop runtime, initiating the layered boot process.

```typescript
apps/electron/src/main/index.ts
```

--------------------------------

### Build Backend

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Use this command to specifically build the backend components of GyShell.

```bash
npm run build:backend
```

--------------------------------

### Development Commands

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/build-commands.md

Run these commands for local development and testing. They cover different environments like Electron, mobile-web, and TUI.

```bash
npm run dev
```

```bash
npm run dev:electron
```

```bash
npm run dev:mobile-web
```

```bash
npm run dev:tui
```

```bash
npm run start:tui
```

```bash
npm run start:backend
```

```bash
npm run start:mobile-web
```

--------------------------------

### Local Quick Forms for `gyll` CLI

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Simplified `gyll` commands for common interactive and non-interactive use cases.

```bash
gyll
gyll "Hello"
gyll run "Run task"
gyll hook "Send and exit"
```

--------------------------------

### Packaging Commands

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/build-commands.md

Commands to package the application for distribution, including backend, Electron app, CLI binaries, and mobile-web assets. Specific commands exist for macOS, Windows, and Linux targets.

```bash
npm run dist
```

```bash
npm run dist:mac
```

```bash
npm run dist:win
```

```bash
npm run dist:linux
```

```bash
npm run dist:linux-arm64
```

--------------------------------

### Build Commands

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/build-commands.md

Use these commands to create production builds for various components of the application. This includes Electron, backend services, TUI, and mobile-web.

```bash
npm run build
```

```bash
npm run build:electron
```

```bash
npm run build:backend
```

```bash
npm run build:tui
```

```bash
npm run build:mobile-web
```

```bash
npm run build:all
```

```bash
npm run build:cli-binaries
```

--------------------------------

### Create Linux ARM64 Distribution

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Builds a distribution package for Linux on ARM64 architecture.

```bash
npm run dist:linux-arm64
```

--------------------------------

### Release Helper Script

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/build-commands.md

The build.sh script is used for building and packaging the application for various platforms including macOS, Windows, and Linux, as well as creating a standalone mobile-web zip.

```bash
./build.sh
```

```bash
./build.sh --mac
```

```bash
./build.sh --win
```

```bash
./build.sh --linux
```

```bash
./build.sh --linux-x64
```

```bash
./build.sh --linux-arm64
```

```bash
./build.sh --mobile-web
```

```bash
./build.sh --help
```

--------------------------------

### Create macOS Distribution

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Builds a distribution package specifically for macOS.

```bash
npm run dist:mac
```

--------------------------------

### Create Distribution Package

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Generates a distribution package for GyShell.

```bash
npm run dist
```

--------------------------------

### Desktop Runtime Boot Flow - Electron Main Initialization

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/monorepo-architecture.md

The function called after the main entry point to further initialize the Electron main process.

```typescript
packages/electron/src/main/startElectronMain.ts
```

--------------------------------

### Quality and Testing Commands

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/build-commands.md

Execute these commands to ensure code quality through type checking and run various levels of tests for different application modules.

```bash
npm run typecheck
```

```bash
npm run typecheck:all
```

```bash
npm run typecheck:backend
```

```bash
npm run typecheck:tui
```

```bash
npm run typecheck:mobile-web
```

```bash
npm run test:backend-regression
```

```bash
npm run test:backend-extreme
```

```bash
npm run test:tui
```

```bash
npm run test:tui-input-automation
```

```bash
npm run test:layout-ui-extreme
```

```bash
npm run test:backend-unit-extreme
```

--------------------------------

### Common `gyll` CLI Commands

Source: https://github.com/mrorangejj/gyshell/blob/main/changelogs/v1.0.0.md

Demonstrates common commands for the `gyll` CLI, including interactive mode, sending messages, running tasks, and connecting to remote backends.

```bash
gyll
gyll "message"
gyll run "message"
gyll hook "message"
gyll --url ip:port ...
gyll --sessionid <id>
```

--------------------------------

### `gyll` CLI with Custom URL

Source: https://github.com/mrorangejj/gyshell/blob/main/changelogs/v1.0.0.md

Connects the `gyll` CLI to a specified backend URL.

```bash
gyll --url ip:port ...
```

--------------------------------

### `gyll` CLI Mode Semantics: Send Message and Enter TUI

Source: https://github.com/mrorangejj/gyshell/blob/main/changelogs/v1.0.0.md

Creates a new session, sends an immediate message, and then enters the TUI.

```bash
gyll "message"
```

--------------------------------

### `gyll` CLI Mode Semantics: Send Once and Exit

Source: https://github.com/mrorangejj/gyshell/blob/main/changelogs/v1.0.0.md

Creates a new session, sends a message once, and then exits immediately.

```bash
gyll hook "message"
```

--------------------------------

### Default `gyll` CLI Behavior

Source: https://github.com/mrorangejj/gyshell/blob/main/changelogs/v1.0.0.md

Shows the default behavior of the `gyll` CLI when no URL is provided, which is to auto-connect to the local desktop backend.

```bash
gyll
```

--------------------------------

### Electron Main Process Composition Root

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/monorepo-architecture.md

Identifies the function responsible for initializing the Electron main process.

```typescript
startElectronMain
```

--------------------------------

### GyShell Monorepo Workspace Layout

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/monorepo-architecture.md

Illustrates the directory structure of the GyShell monorepo, showing the organization of applications and packages.

```text
GyShell/
├── apps/
│   ├── electron/           # thin wrapper: entry/preload/build/package config
│   ├── gybackend/          # thin wrapper: backend process entry
│   ├── mobile-web/         # thin wrapper: vite host + mount entry
│   └── tui/                # thin wrapper: CLI entry + binary build scripts
├── packages/
│   ├── backend/            # core backend runtime (agent/gateway/terminal/services)
│   ├── electron/           # electron-only implementation (main/gateway/settings/theme)
│   ├── mobile-web/         # mobile-web UI implementation
│   ├── tui/                # tui UI implementation
│   ├── ui/                 # desktop renderer UI implementation
│   └── shared/             # shared cross-surface models/utilities
├── docs/
│   ├── monorepo-architecture.md
│   └── build-commands.md
└── package.json
```

--------------------------------

### Run GyShell Smoke Test

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/tui/README.md

Execute the smoke tests for the GyShell TUI workspace using npm.

```bash
npm --workspace @gyshell/tui run test:smoke
```

--------------------------------

### Build TUI

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Command to build the Text User Interface (TUI) for GyShell.

```bash
npm run build:tui
```

--------------------------------

### `gyll` CLI Mode Semantics: Run and Stream Output

Source: https://github.com/mrorangejj/gyshell/blob/main/changelogs/v1.0.0.md

Creates a new session, streams output directly to the terminal without entering the TUI.

```bash
gyll run "message"
```

--------------------------------

### `gyll` CLI with Session ID

Source: https://github.com/mrorangejj/gyshell/blob/main/changelogs/v1.0.0.md

Connects the `gyll` CLI to a specific session using its ID.

```bash
gyll --sessionid <id>
```

--------------------------------

### UI Synchronization Events

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/monorepo-architecture.md

Lists the key events related to session profile locking and readiness synchronization.

```text
SESSION_PROFILE_LOCKED
SESSION_READY
```

--------------------------------

### Resume Target Session with `gyll`

Source: https://github.com/mrorangejj/gyshell/blob/main/README.md

Command to resume a previous GyShell session using its ID.

```bash
gyll --sessionid "your-session-id"
```

--------------------------------

### Mobile-Web Runtime Controller

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/monorepo-architecture.md

Points to the main controller hook for the mobile-web client implementation.

```typescript
useMobileController
```

--------------------------------

### Manual Connection to Backend Gateway

Source: https://github.com/mrorangejj/gyshell/blob/main/docs/mobile-web-usage.md

When using the standalone mobile-web page or a custom deployment, configure the Gateway URL in the Settings panel. For non-localhost access, an access token may be required.

```text
ws://192.168.1.8:17888
```

--------------------------------

### GyShell CLI Run Mode

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/tui/README.md

Use the 'run' command with the GyShell CLI to send a message and stream AI output directly to the terminal without entering the TUI.

```bash
gyll run [--url 127.0.0.1:17888] [--timeout 3000] "message"
```

--------------------------------

### GyShell CLI Basic Usage

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/tui/README.md

Interact with the GyShell CLI by sending a message directly. This mode does not enter the TUI and streams AI output to the terminal.

```bash
gyll [--url 127.0.0.1:17888] [--timeout 3000] "message"
```

--------------------------------

### GyShell CLI Hook Mode

Source: https://github.com/mrorangejj/gyshell/blob/main/apps/tui/README.md

Utilize the 'hook' command with the GyShell CLI to send a single message and exit, while the backend continues to run. This mode does not enter the TUI.

```bash
gyll hook [--url 127.0.0.1:17888] [--timeout 3000] "message"
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.