Clix CLI

An interactive AI-powered assistant for Clix SDK development. Built with React and Ink, Clix CLI provides a chat interface with AI agents to help you integrate, debug, and manage the Clix Mobile SDK in your projects.

Features

Interactive Chat Interface: Natural conversation with AI agents using streaming responses
Multiple AI Agents: Support for Claude Code and Codex
13 Slash Commands: Quick actions for common tasks and workflows
Skills System: Pre-built workflows for SDK integration, event tracking, user management, and personalization
Debug Assistant: Interactive problem diagnosis and root cause analysis
Session Transfer: Save and continue conversations in native agent CLIs
Agent Switching: Switch between Claude and Codex mid-conversation with full history preservation
Context Management: Real-time tracking with automatic history compaction at 90% threshold
MCP Server Integration: Built-in installer for Clix MCP Server

Installation

Install via npm (Recommended)

npm install -g @clix-so/clix-cli

Install via Bun

bun add -g @clix-so/clix-cli

Install from GitHub (Development/Latest)

Install directly from the GitHub repository to get the latest development version:

# Install globally
npm install -g github:clix-so/clix-cli

# Or run without installing
npx github:clix-so/clix-cli

Install from specific branch or commit:

# Install from specific branch
npm install -g github:clix-so/clix-cli#feature-branch

# Install from specific commit
npm install -g github:clix-so/clix-cli#abc1234

Install via Script

curl -fsSL https://cli.clix.so/install.sh | bash

Install via Homebrew (macOS)

brew tap clix-so/clix-cli
brew install clix

Uninstallation

See UNINSTALL.md for instructions on how to remove Clix CLI.

Prerequisites

Node.js 20+ (Bun v1.0+ is optional for faster development)
One of the following AI agents:
- Claude Code - Anthropic's Claude-powered coding assistant
- Codex - OpenAI's Codex-powered coding assistant

Quick Start

Start interactive chat:

clix

Select your AI agent (if multiple are available):

clix agent claude

Use natural language or slash commands:

> How do I integrate Clix SDK into my iOS project?
> /debug
> /integrate

Commands

`clix` (default)

Start an interactive chat session with your configured AI agent.

clix

Features:

Natural language conversation
Real-time streaming responses
13 slash commands for quick actions
Context tracking with usage indicators
History navigation (↑/↓ arrows)
Press Escape to cancel streaming

Shortcuts:

/help - Show all available commands
/debug - Interactive debugging assistant
/integrate - SDK integration guide
/agent - Switch AI agents
/transfer - Transfer session to native CLI
/exit - Exit chat

`clix agent [name]`

List available AI agents or switch to a specific agent.

# List available agents
clix agent

# Switch to Claude
clix agent claude

# Switch to Codex
clix agent codex

Detects available agents (Claude Code, Codex) on your system. Your selection is saved to ~/.clix/config.json.

`clix install`

Install the Clix SDK into your project with AI assistance.

clix install

# Use custom installation prompt
clix install --prompt-url https://example.com/custom-prompt.txt

Options:

-p, --prompt-url <url> - Custom URL for installation instructions

`clix integrate`

SDK integration guide for your platform.

clix integrate
clix integrate --platform ios

`clix track`

Event tracking setup with Clix.trackEvent().

clix track
clix track --platform android

`clix user`

User management and identification setup.

clix user

`clix personalize`

Personalization templates setup.

clix personalize

`clix diagnose`

Analyze SDK integration status in your project.

clix diagnose

`clix debug <problem>`

Interactive debugging assistant for troubleshooting issues.

clix debug "Push notifications not working on iOS"

`clix install-mcp [agent]`

Install Clix MCP Server for enhanced AI assistance.

# Auto-detect agent
clix install-mcp

# Install for specific agent
clix install-mcp claude
clix install-mcp codex

Slash Commands

Use these commands within the interactive chat (clix):

Skills

/integrate - SDK integration guide
/track - Event tracking setup
/user - User management setup
/personalize - Personalization templates

System Commands

/diagnose - Diagnose SDK integration status
/debug - Interactive debugging assistant
/install-mcp - Install Clix MCP Server
/agent - List or switch agents
/transfer - Transfer session to agent CLI
/help - Show available commands
/clear - Clear chat history
/compact - Compress conversation history
/exit - Exit the chat

Interactive Features

Debug Assistant

The /debug command provides interactive problem diagnosis:

Type /debug in chat
Describe your problem (e.g., "Push notifications not working on iOS")
AI investigates your project structure and code
Receive root cause analysis and recommended fixes

> /debug
Describe the problem: Events not appearing in Clix dashboard
[AI explores project, identifies issue, provides fixes]

Session Transfer

Transfer your conversation to continue in the native agent CLI:

> /transfer claude
✅ Session saved to ~/.clix/session-1234567890.md

To continue in Claude Code:
claude "$(cat ~/.clix/session-1234567890.md)"

This preserves your entire conversation history and allows you to continue seamlessly in the agent's native interface.

Agent Switching

Switch between Claude and Codex without losing your conversation:

> /agent codex
Switching to Codex...
[Conversation history preserved]

Skills

Pre-built workflows help with common SDK tasks:

Platform Detection: Automatically detects iOS, Android, React Native, or Flutter
Step-by-Step Guidance: AI guides you through each step
Best Practices: Follows Clix SDK best practices and conventions

Available skills: integrate, track, user, personalize

Project Structure

src/
├── cli.tsx                 # Main CLI entry point
├── commands/               # Command implementations
│   ├── agent.tsx           # Agent management
│   ├── chat.tsx            # Interactive chat
│   ├── debug.tsx           # Debug assistant
│   ├── install.tsx         # SDK installation
│   ├── install-mcp.tsx     # MCP server installation
│   └── skill/              # Skills command
├── lib/                    # Core functionality
│   ├── agents.ts           # Agent detection
│   ├── config.ts           # Configuration management
│   ├── executor.ts         # Agent executor interface
│   ├── executors/          # Agent implementations
│   │   ├── claude-executor.ts
│   │   └── codex-executor.ts
│   ├── services/           # Service modules
│   │   ├── debug-service.ts
│   │   ├── history-compaction.ts
│   │   ├── mcp-install-service.ts
│   │   └── transfer-service.ts
│   └── skills.ts           # Skills system
└── ui/                     # User interface
    ├── chat/               # Chat interface
    │   ├── ChatApp.tsx
    │   ├── components/     # Chat components
    │   ├── context/        # React context
    │   └── hooks/          # Chat hooks
    └── components/         # Reusable UI components

Development

See CONTRIBUTING.md for detailed development guide.

Quick Start

# Clone the repository
git clone https://github.com/clix-so/clix-cli.git
cd clix-cli

# Install dependencies
bun install

# Run in development mode
bun run dev

# Build
bun run build

# Compile binaries
bun run build:binary

# Run tests
bun test

Contributing

Pull requests and issues are welcome! See CONTRIBUTING.md for:

Development setup and workflow
Code contribution process
Testing guidelines
Release process

License

MIT

Links

GitHub Repository
Issue Tracker
Homebrew Tap
Clix SDK Documentation
LLMs.txt - Detailed documentation for AI assistants

Made with love by the Clix team

Name		Name	Last commit message	Last commit date
Latest commit History 34 Commits
.github		.github
.husky		.husky
dist		dist
scripts		scripts
src		src
tests/e2e		tests/e2e
.gitignore		.gitignore
.lintstagedrc.json		.lintstagedrc.json
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
GEMINI.md		GEMINI.md
LICENSE		LICENSE
README.md		README.md
UNINSTALL.md		UNINSTALL.md
biome.json		biome.json
bun.lock		bun.lock
bunfig.toml		bunfig.toml
llms.txt		llms.txt
package.json		package.json
tsconfig.json		tsconfig.json

License

clix-so/clix-cli

Folders and files

Latest commit

History

Repository files navigation

Clix CLI

Features

Installation

Install via npm (Recommended)

Install via Bun

Install from GitHub (Development/Latest)

Install via Script

Install via Homebrew (macOS)

Uninstallation

Prerequisites

Quick Start

Commands

clix (default)

clix agent [name]

clix install

clix integrate

clix track

clix user

clix personalize

clix diagnose

clix debug <problem>

clix install-mcp [agent]

Slash Commands

Skills

System Commands

Interactive Features

Debug Assistant

Session Transfer

Agent Switching

Skills

Project Structure

Development

Quick Start

Contributing

License

Links

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Languages

`clix` (default)

`clix agent [name]`

`clix install`

`clix integrate`

`clix track`

`clix user`

`clix personalize`

`clix diagnose`

`clix debug <problem>`

`clix install-mcp [agent]`