tide-cli

🌊 Tide CLI

Local-first AI command line tool for developers

Installation • Quick Start • Features • Development

Tide CLI is a local-first AI command line tool that combines multiple offline agents for coding, documentation, and shell tasks into one streamlined workflow. It runs entirely on your machine, with no authentication or cloud dependency.

✨ Features

• 🔒 100% Local - No cloud dependencies, runs entirely offline
• 🤖 Multiple AI Agents - Specialized agents for coding, documentation, and shell tasks
• ⚡ Fast & Efficient - Optimized for local inference with memory management
• 🛠️ Developer-First - Built by developers, for developers
• 🌊 Streamlined Workflow - Combines multiple tasks into cohesive workflows

📦 Installation

Prerequisites

Ensure you have Node.js version 20 or higher installed.

Install from npm

npm install -g @tide-cli/tide-cli
tide --version

Install from source

git clone https://github.com/TideCLI/tide-cli.git
cd tide-cli
npm install
npm run build
npm link

🚀 Quick Start

# Start Tide CLI
tide

# Get help
tide --help

# Check version
tide --version

🏗️ Development

This project uses a monorepo structure with npm workspaces:

tide-cli/
├── packages/
│   ├── cli/           # Main CLI application
│   └── core/          # Core business logic and AI agents
├── scripts/           # Build and utility scripts
└── docs/             # Documentation

Development Setup

# Clone the repository
git clone https://github.com/TideCLI/tide-cli.git
cd tide-cli

# Install dependencies
npm install

# Build all packages
npm run build

# Start development
npm run start

Available Scripts

• npm run build - Build all packages
• npm run start - Start the CLI
• npm run test - Run tests
• npm run lint - Lint code
• npm run format - Format code
• npm run clean - Clean build artifacts

📁 Project Structure

Packages

• @tide-cli/tide-cli - Main CLI package with terminal UI
• @tide-cli/tide-cli-core - Core functionality, AI agents, and tools

Technology Stack

• Runtime: Node.js 20+
• Language: TypeScript with strict configuration
• UI Framework: React + Ink (for terminal UI)
• Build System: ESBuild + TypeScript
• Testing: Vitest
• Package Manager: npm with workspaces