{"id":37229705,"url":"https://github.com/clix-so/clix-cli","last_synced_at":"2026-01-18T11:16:27.847Z","repository":{"id":331907447,"uuid":"1129463466","full_name":"clix-so/clix-cli","owner":"clix-so","description":"Interactive AI-powered CLI assistant for Clix SDK integration.","archived":false,"fork":false,"pushed_at":"2026-01-11T15:53:24.000Z","size":1685,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-11T18:46:45.721Z","etag":null,"topics":["bun","cli","fcm","firebase","mobile","notifications","push-notification","sdk","typescript"],"latest_commit_sha":null,"homepage":"https://docs.clix.so/clix-cli","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clix-so.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-07T06:02:44.000Z","updated_at":"2026-01-11T15:38:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/clix-so/clix-cli","commit_stats":null,"previous_names":["clix-so/clix-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/clix-so/clix-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clix-so%2Fclix-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clix-so%2Fclix-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clix-so%2Fclix-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clix-so%2Fclix-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clix-so","download_url":"https://codeload.github.com/clix-so/clix-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clix-so%2Fclix-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28442288,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-15T00:55:22.719Z","status":"online","status_checked_at":"2026-01-15T02:00:08.019Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bun","cli","fcm","firebase","mobile","notifications","push-notification","sdk","typescript"],"created_at":"2026-01-15T03:34:10.988Z","updated_at":"2026-01-15T03:34:11.578Z","avatar_url":"https://github.com/clix-so.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Clix CLI\n\nAn 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.\n\n## Features\n\n- **Interactive Chat Interface**: Natural conversation with AI agents using streaming responses\n- **Multiple AI Agents**: Support for Claude Code and Codex\n- **13 Slash Commands**: Quick actions for common tasks and workflows\n- **Skills System**: Pre-built workflows for SDK integration, event tracking, user management, and personalization\n- **Debug Assistant**: Interactive problem diagnosis and root cause analysis\n- **Session Transfer**: Save and continue conversations in native agent CLIs\n- **Agent Switching**: Switch between Claude and Codex mid-conversation with full history preservation\n- **Context Management**: Real-time tracking with automatic history compaction at 90% threshold\n- **MCP Server Integration**: Built-in installer for Clix MCP Server\n\n## Installation\n\n### Install via npm (Recommended)\n\n```bash\nnpm install -g @clix-so/clix-cli\n```\n\n### Install via Bun\n\n```bash\nbun add -g @clix-so/clix-cli\n```\n\n### Install via Script\n\n```bash\ncurl -fsSL https://cli.clix.so/install.sh | bash\n```\n\n### Install via Homebrew (macOS)\n\n```bash\nbrew tap clix-so/clix-cli\nbrew install clix\n```\n\n### Uninstallation\n\nSee [UNINSTALL.md](UNINSTALL.md) for instructions on how to remove Clix CLI.\n\n## Prerequisites\n\n- **Node.js 20+** (Bun v1.0+ is optional for faster development)\n- **One of the following AI agents**:\n  - [Claude Code](https://code.claude.com/docs) - Anthropic's Claude-powered coding assistant\n  - [Codex](https://developers.openai.com/codex/cli) - OpenAI's Codex-powered coding assistant\n\n## Quick Start\n\n1. **Start interactive chat**:\n\n```bash\nclix\n```\n\n2. **Select your AI agent** (if multiple are available):\n\n```bash\nclix agent claude\n```\n\n3. **Use natural language or slash commands**:\n\n```\n\u003e How do I integrate Clix SDK into my iOS project?\n\u003e /debug\n\u003e /integration\n```\n\n## Commands\n\n### `clix` (default)\n\nStart an interactive chat session with your configured AI agent.\n\n```bash\nclix\n```\n\n**Features:**\n\n- Natural language conversation\n- Real-time streaming responses\n- 13 slash commands for quick actions\n- Context tracking with usage indicators\n- History navigation (↑/↓ arrows)\n- Press Escape to cancel streaming\n\n**Shortcuts:**\n\n- `/help` - Show all available commands\n- `/debug` - Interactive debugging assistant\n- `/install` - Autonomous SDK installation\n- `/diagnose` - SDK diagnosis\n- `/integration` - Interactive SDK integration guide\n- `/agent` - Switch AI agents\n- `/transfer` - Transfer session to native CLI\n- `/exit` - Exit chat\n\n### `clix agent [name]`\n\nList available AI agents or switch to a specific agent.\n\n```bash\n# List available agents\nclix agent\n\n# Switch to Claude\nclix agent claude\n\n# Switch to Codex\nclix agent codex\n```\n\nDetects available agents (Claude Code, Codex) on your system. Your selection is saved to `~/.clix/config.json`.\n\n### `clix install`\n\nAutonomous SDK installation with automatic file modifications. The AI agent will detect your platform, install dependencies, create initialization files, and integrate the SDK without manual intervention.\n\n```bash\nclix install\n\n# Specify target platform\nclix install --platform react-native\nclix install --platform ios\n```\n\n**Options:**\n\n- `--platform \u003cplatform\u003e` - Target platform (ios, android, react-native, flutter)\n\n### `clix diagnose`\n\nAnalyze SDK integration status in your project.\n\n```bash\nclix diagnose\n```\n\n### Interactive Skills (Chat Mode Only)\n\nThe following skills require step-by-step guidance and are only available in chat mode. Run `clix` to start interactive chat, then use `/\u003cskill\u003e` commands.\n\n#### `integration`\n\nSDK integration guide with step-by-step instructions. Unlike `clix install`, this provides interactive guidance for manual integration.\n\n```\n\u003e clix\n\u003e /integration\n```\n\n#### `event-tracking`\n\nEvent tracking setup with `Clix.trackEvent()`.\n\n```\n\u003e clix\n\u003e /event-tracking\n```\n\n#### `user-management`\n\nUser management and identification setup.\n\n```\n\u003e clix\n\u003e /user-management\n```\n\n#### `personalization`\n\nPersonalization templates setup.\n\n```\n\u003e clix\n\u003e /personalization\n```\n\n#### `api-triggered-campaigns`\n\nAPI-triggered campaign setup.\n\n```\n\u003e clix\n\u003e /api-triggered-campaigns\n```\n\n### `clix debug \u003cproblem\u003e`\n\nInteractive debugging assistant for troubleshooting issues.\n\n```bash\nclix debug \"Push notifications not working on iOS\"\n```\n\n### `clix install-mcp [agent]`\n\nInstall Clix MCP Server for enhanced AI assistance.\n\n```bash\n# Auto-detect agent\nclix install-mcp\n\n# Install for specific agent\nclix install-mcp claude\nclix install-mcp codex\n```\n\n## Slash Commands\n\nUse these commands within the interactive chat (`clix`):\n\n### Autonomous Skills\n\n- `/install` - Autonomous SDK installation (automatic file modifications)\n- `/diagnose` - Diagnose SDK integration status\n\n### Interactive Skills\n\n- `/integration` - SDK integration guide (step-by-step instructions)\n- `/event-tracking` - Event tracking setup\n- `/user-management` - User management setup\n- `/personalization` - Personalization templates\n- `/api-triggered-campaigns` - API-triggered campaign setup\n\n### System Commands\n\n- `/debug` - Interactive debugging assistant\n- `/install-mcp` - Install Clix MCP Server\n- `/agent` - List or switch agents\n- `/transfer` - Transfer session to agent CLI\n- `/help` - Show available commands\n- `/clear` - Clear chat history\n- `/compact` - Compress conversation history\n- `/exit` - Exit the chat\n\n## Interactive Features\n\n### Debug Assistant\n\nThe `/debug` command provides interactive problem diagnosis:\n\n1. Type `/debug` in chat\n2. Describe your problem (e.g., \"Push notifications not working on iOS\")\n3. AI investigates your project structure and code\n4. Receive root cause analysis and recommended fixes\n\n```\n\u003e /debug\nDescribe the problem: Events not appearing in Clix dashboard\n[AI explores project, identifies issue, provides fixes]\n```\n\n### Session Transfer\n\nTransfer your conversation to continue in the native agent CLI:\n\n```\n\u003e /transfer claude\n✅ Session saved to ~/.clix/session-1234567890.md\n\nTo continue in Claude Code:\nclaude \"$(cat ~/.clix/session-1234567890.md)\"\n```\n\nThis preserves your entire conversation history and allows you to continue seamlessly in the agent's native interface.\n\n### Agent Switching\n\nSwitch between Claude and Codex without losing your conversation:\n\n```\n\u003e /agent codex\nSwitching to Codex...\n[Conversation history preserved]\n```\n\n### Skills\n\nPre-built workflows help with common SDK tasks:\n\n#### Autonomous Skills (Command-Line Mode)\n\nThese skills can be executed directly from the command-line for autonomous operation:\n\n- `install` - SDK Installation (autonomous file modifications)\n- `diagnose` - SDK Diagnosis (diagnostic report generation)\n\nUsage: `clix install`, `clix diagnose`\n\n#### Interactive Skills (Chat Mode Only)\n\nThese skills require step-by-step guidance and user approval:\n\n- `integration` - SDK Integration Guide\n- `event-tracking` - Event Tracking Setup\n- `user-management` - User Management Setup\n- `personalization` - Personalization Setup\n- `api-triggered-campaigns` - API-Triggered Campaigns Setup\n\nUsage: Run `clix` to start chat mode, then use `/\u003cskill\u003e` commands (e.g., `/integration`)\n\n**Features:**\n\n- **Platform Detection**: Automatically detects iOS, Android, React Native, or Flutter\n- **Step-by-Step Guidance**: AI guides you through each step (interactive skills)\n- **Best Practices**: Follows Clix SDK best practices and conventions\n\n## Project Structure\n\n```\nsrc/\n├── cli.tsx                 # Main CLI entry point\n├── commands/               # Command implementations\n│   ├── agent.tsx           # Agent management\n│   ├── chat.tsx            # Interactive chat\n│   ├── debug.tsx           # Debug assistant\n│   ├── install.tsx         # SDK installation\n│   ├── install-mcp.tsx     # MCP server installation\n│   └── skill/              # Skills command\n├── lib/                    # Core functionality\n│   ├── agents.ts           # Agent detection\n│   ├── config.ts           # Configuration management\n│   ├── executor.ts         # Agent executor interface\n│   ├── executors/          # Agent implementations\n│   │   ├── claude-executor.ts\n│   │   └── codex-executor.ts\n│   ├── services/           # Service modules\n│   │   ├── debug-service.ts\n│   │   ├── history-compaction.ts\n│   │   ├── mcp-install-service.ts\n│   │   └── transfer-service.ts\n│   └── skills.ts           # Skills system\n└── ui/                     # User interface\n    ├── chat/               # Chat interface\n    │   ├── ChatApp.tsx\n    │   ├── components/     # Chat components\n    │   ├── context/        # React context\n    │   └── hooks/          # Chat hooks\n    └── components/         # Reusable UI components\n```\n\n## Development\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development guide.\n\n### Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/clix-so/clix-cli.git\ncd clix-cli\n\n# Install dependencies\nbun install\n\n# Run in development mode\nbun run dev\n\n# Build\nbun run build\n\n# Compile binaries\nbun run build:binary\n\n# Run tests\nbun test\n```\n\n## Contributing\n\nPull requests and issues are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for:\n\n- Development setup and workflow\n- Code contribution process\n- Testing guidelines\n- Release process\n\n## License\n\nMIT\n\n## Links\n\n- [GitHub Repository](https://github.com/clix-so/clix-cli)\n- [Issue Tracker](https://github.com/clix-so/clix-cli/issues)\n- [Homebrew Tap](https://github.com/clix-so/homebrew-clix-cli)\n- [Clix SDK Documentation](https://clix.so)\n- [LLMs.txt](llms.txt) - Detailed documentation for AI assistants\n\n---\n\nMade with love by the Clix team\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclix-so%2Fclix-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclix-so%2Fclix-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclix-so%2Fclix-cli/lists"}