# cxclihub

**Repository Path**: mgdh5/cxclihub

## Basic Information

- **Project Name**: cxclihub
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CxCliHub

CxCliHub is a local web hub for managing multiple Codex CLI sessions without opening many terminal windows.

## Scope

V1 is macOS-first and uses tmux to keep Codex sessions alive.

## Requirements

- Node.js 24 for local development. This repo uses `better-sqlite3`, so running with a different major Node version can require rebuilding native bindings.
- Codex CLI available as `codex`
- tmux

## Install

```bash
npm install -g cxclihub
```

## Run

```bash
cxclihub
cxclihub --no-open
cxclihub --port 5177
```

## Local Development

Use Node 24 when running the local server, tests, or builds. On this machine the Node 24 binary is installed through Homebrew as `node@24`.

Start the local development server and open the browser automatically:

```bash
PATH="$(brew --prefix node@24)/bin:$PATH" npm run dev
```

Or use the convenience script:

```bash
npm run dev:node24
```

The command prints a local URL with an auth token, for example:

```text
http://127.0.0.1:53616/?token=...
```

The browser should open automatically. If it does not, open that exact URL manually.

If the browser shows `Not found`, stop the old local server and start again:

```bash
npm run stop
npm run dev:node24
```

To start the server without opening a browser:

```bash
npm run dev:node24:no-open
```

Common Node 24 checks:

```bash
npm run test:node24
npm run lint:node24
```

## Environment

```bash
CXCLIHUB_HOME=/path/to/data cxclihub
CXCLIHUB_CODEX_BIN=/path/to/codex cxclihub
```

## Security

The server listens only on `127.0.0.1`. Each run uses a random token required by HTTP and WebSocket requests.

## Live Session Recovery

Use the copied command:

```bash
tmux attach -t <tmux-session-name>
```

## Ended Session Resume

Use Resume, Full Access Resume, or Resume with options. Full Access Resume sets `--sandbox danger-full-access`; it does not automatically add `--dangerously-bypass-approvals-and-sandbox`.