Grok CLI

1.1.35 – Paste Text Summary Feature

This release includes latest updates and automated publishing via GitHub Actions.

Fixes all Read/Update tool reliability issues
Ensures consistent FS imports (node: namespace)
Adds proper Node shebang for global installs
Temporarily removes experimental features (e.g. compress)

Grok CLI

A conversational AI CLI tool powered by Grok with Claude Code-level intelligence and advanced tool capabilities.

🔗 Quick Links

📦 NPM Package - Install globally with npm install -g grok-cli-hurry-mode
🐙 GitHub Repository - Source code, issues, and contributions
🎯 Competitive Parity Analysis - Strategic analysis vs Claude Code, Cursor IDE, and OpenAI Codex
💬 xAI Community Discord - Official xAI API community support
📚 Releases - Version history and changelogs

🆕 What's New in v1.0+

🎯 P0: Plan Mode - Claude Code Parity (Latest)

🎯 Shift+Tab Twice Activation: Exact Claude Code Plan Mode with read-only exploration
🔍 Comprehensive Codebase Analysis: Project structure, dependencies, complexity metrics, and architecture patterns
🧠 AI-Powered Implementation Planning: Strategic plan generation using Grok models with risk assessment
🛡️ Read-Only Tool Execution: Safe exploration with destructive operation blocking and simulation
📊 Progress Visualization: Real-time exploration and planning progress with phase-specific guidance
📋 User Approval Workflow: Complete plan review and confirmation before execution
⚡ Performance Optimized: Fast exploration (1-15 seconds) with intelligent caching and filtering

🎨 P4: UX Refinement - Claude Code Feel

🎭 Enhanced Welcome Banner: Professional ASCII art with context-aware status display
🌈 Unified Color System: Consistent Claude Code-inspired visual hierarchy across all interfaces
🔄 Contextual Spinners: 8 operation-specific animated indicators (🧠 thinking, 🔍 search, 📂 indexing, 📝 write, etc.)
📊 Progress Indicators: Advanced progress bars with ETA calculations and breathing pulse effects
🎛️ Background Activity: Non-intrusive workspace awareness with file change monitoring
🎯 UI State Management: Centralized coordination for all visual feedback and notifications
⚡ Motion Design: 120ms smooth animations with 1.5s breathing rhythm for calm, responsive feel
🧠 Context Tooltip: Press Ctrl+I for instant workspace insights (project name, git branch, file count, session state)
📈 Dynamic Status: Real-time memory pressure, background activity, and workspace intelligence
🎨 Context Awareness Surface: Professional bordered layouts with organized information sections

🧠 P3: Code Intelligence Tools

🔍 AST Parser: Language-specific syntax tree analysis for TypeScript, JavaScript, Python
🔎 Symbol Search: Fuzzy search across codebases with cross-references and usage analysis
📊 Dependency Analyzer: Circular dependency detection and dependency graph generation
🎯 Code Context: Semantic analysis with quality metrics and design pattern detection
🔧 Refactoring Assistant: Safe rename, extract, inline operations with preview and rollback

🚀 P2: Enhanced File Operations

⚡ Multi-File Editor: Atomic operations with transaction support and rollback
🔍 Advanced Search Tool: Regex patterns with bulk replace and context-aware results
🌳 File Tree Operations: Visual trees, bulk operations, and intelligent file organization
🧠 Code-Aware Editor: Syntax-aware editing with smart refactoring capabilities
📚 Operation History: Comprehensive undo/redo system with persistent history

🎯 Result: Claude Code-level capabilities with Claude Code feel in your terminal!

🛠️ P1: Reliability & Workflow Enhancements

🤖 .agent System: AI-powered task management and documentation system for efficient workflows
🔧 Healer Script: Automated issue detection and resolution for tool reliability
⚡ FsPort Abstraction: Improved file system operations with Node built-ins externalization
📦 Automated Installer: Enhanced installation UX with one-click setup options
🛡️ Tool Reliability Fixes: Standardized imports, syntax error resolution, and fallback mechanisms
📋 Paste Text Summary: Claude Code-style paste detection with smart summarization ([Pasted text #1 +12 lines])

✨ Features

🎯 Plan Mode - Claude Code's Signature Feature

🎯 Shift+Tab Twice: Activate read-only exploration mode (exact Claude Code parity)
🔍 Codebase Analysis: Comprehensive project structure, dependencies, and complexity analysis
🧠 AI-Powered Planning: Strategic implementation plans generated by Grok models
🛡️ Read-Only Safety: Zero file modifications during exploration with tool simulation
📊 Progress Tracking: Real-time exploration progress with phase-specific guidance
📋 Plan Approval: Review and approve implementation plans before execution

🧠 Claude Code-Level Intelligence

🔍 AST Code Analysis: Parse TypeScript, JavaScript, Python files to extract symbols, imports, and structure
🔎 Symbol Search: Fuzzy search for functions, classes, variables across entire codebases
📊 Dependency Analysis: Detect circular dependencies and generate dependency graphs
🎯 Code Context: Intelligent relationship mapping with semantic analysis and quality metrics
🔧 Safe Refactoring: Rename, extract, inline operations with preview and rollback support

🚀 Advanced File Operations

⚡ MultiEdit: Atomic operations across multiple files with transaction support
🔍 Grep/Glob: Advanced search with regex patterns and file discovery
🌐 WebFetch/WebSearch: Real-time web content retrieval and search capabilities
📚 Task/TodoWrite: Specialized agent delegation and comprehensive task management
🚀 Read/Write/Edit: Claude Code-standard file operations at high speed

🌐 Visit grokcli.dev for complete documentation and guides.

🤖 Core AI Capabilities

💬 Conversational Interface: Natural language powered by Grok models
🔧 Intelligent Tool Selection: AI automatically chooses the right tools for your requests
⚡ Bash Integration: Execute shell commands through natural conversation
🔌 MCP Extension: Extend capabilities with Model Context Protocol servers (Linear, GitHub, etc.)
💻 Beautiful Terminal UI: Interactive interface with Claude Code-style animations and feedback
📋 Smart Paste Detection: Large pasted content automatically summarizes as [Pasted text #1 +12 lines] for clean chat history

🎨 Enhanced User Experience

🎭 Professional Welcome Banner: ASCII art with dynamic context status (Context: Dynamic │ Files: indexed │ Session: Restored)
🔄 Contextual Visual Feedback: 8 operation-specific spinners with smooth 120ms animations
📊 Progress Transparency: Real-time progress bars with ETA calculations for long operations
🎛️ Background Awareness: Subtle workspace indexing and file watching indicators
🌈 Consistent Color Language: Claude Code-inspired visual hierarchy (info=blue, success=green, warn=orange, error=red)
⚡ Motion Design: Breathing pulse effects and smooth transitions for calm, responsive interface

📚 Documentation System

🏗️ Agent Documentation: Complete .agent/ system for AI context optimization
📖 Interactive Commands: /docs menu, /readme generation, /api-docs, /changelog
🔄 Smart Updates: /update-agent-docs with configurable auto-triggers
🤖 Subagent Framework: Token-optimized processing with specialized agents
🛡️ Self-Healing: /heal command captures incidents and generates guardrails
📝 Code Comments: /comments command for automatic code documentation

🌍 Installation & Setup

📦 Global Installation: Install anywhere with npm install -g grok-cli-hurry-mode
⚙️ Flexible Configuration: Environment variables, user settings, or project-specific configs
🔄 CI/CD Ready: Headless mode perfect for automation and scripting

Installation

Prerequisites

Node.js 18+ (Node.js 20+ recommended)

🚀 Quick Start

Option 1: Run without installing (Recommended)

npx -y grok-cli-hurry-mode@latest

Always gets the latest version, no local installation needed

Option 2: Global installation

npm install -g grok-cli-hurry-mode@latest

Option 3: Alternative package managers

# Using Yarn
yarn global add grok-cli-hurry-mode@latest

# Using pnpm
pnpm add -g grok-cli-hurry-mode@latest

# Using bun
bun add -g grok-cli-hurry-mode@latest

🛠️ PATH Setup (If `grok` command not found)

After installation, if you get "command not found", add npm's global bin to your PATH:

macOS/Linux:

# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Or for bash users:
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Windows:

# PowerShell
$npmPath = npm config get prefix
$env:PATH += ";$npmPath"

Verify installation:

grok --version  # Should show current version
which grok      # Should show installation path

⚡ Quick Start (One-liner)

Try without installing:

GROK_API_KEY=your_api_key_here npx -y grok-cli-hurry-mode@latest --help

Or install globally:

npm install -g grok-cli-hurry-mode@latest && \
echo 'export GROK_API_KEY=your_api_key_here' >> ~/.zshrc && \
source ~/.zshrc && \
grok --help

Local Development

git clone <repository>
cd grok-cli
npm install
npm run build
npm link

Setup

Get your Grok API key from X.AI
Set up your API key (choose one method):

Method 1: Environment Variable

export GROK_API_KEY=your_api_key_here

Method 2: .env File

cp .env.example .env
# Edit .env and add your API key

Method 3: Command Line Flag

grok --api-key your_api_key_here

Method 4: User Settings File Create ~/.grok/user-settings.json:

{
  "apiKey": "your_api_key_here"
}

(Optional, Recommended) Get your Morph API key from Morph Dashboard
Set up your Morph API key for Fast Apply editing (choose one method):

Method 1: Environment Variable

export MORPH_API_KEY=your_morph_api_key_here

Method 2: .env File

# Add to your .env file
MORPH_API_KEY=your_morph_api_key_here

Custom Base URL (Optional)

By default, the CLI uses https://api.x.ai/v1 as the Grok API endpoint. You can configure a custom endpoint if needed (choose one method):

Method 1: Environment Variable

export GROK_BASE_URL=https://your-custom-endpoint.com/v1

Method 2: Command Line Flag

grok --api-key your_api_key_here --base-url https://your-custom-endpoint.com/v1

Method 3: User Settings File Add to ~/.grok/user-settings.json:

{
  "apiKey": "your_api_key_here",
  "baseURL": "https://your-custom-endpoint.com/v1"
}

Configuration Files

Grok CLI uses two types of configuration files to manage settings:

User-Level Settings (`~/.grok/user-settings.json`)

This file stores global settings that apply across all projects. These settings rarely change and include:

API Key: Your Grok API key
Base URL: Custom API endpoint (if needed)
Default Model: Your preferred model (e.g., grok-code-fast-1)
Available Models: List of models you can use

Example:

{
  "apiKey": "your_api_key_here",
  "baseURL": "https://api.x.ai/v1",
  "defaultModel": "grok-code-fast-1",
  "models": [
    "grok-code-fast-1",
    "grok-4-latest",
    "grok-3-latest",
    "grok-3-fast",
    "grok-3-mini-fast"
  ]
}

Project-Level Settings (`.grok/settings.json`)

This file stores project-specific settings in your current working directory. It includes:

Current Model: The model currently in use for this project
MCP Servers: Model Context Protocol server configurations

Example:

{
  "model": "grok-3-fast",
  "mcpServers": {
    "linear": {
      "name": "linear",
      "transport": "stdio",
      "command": "npx",
      "args": ["@linear/mcp-server"]
    }
  }
}

How It Works

Global Defaults: User-level settings provide your default preferences
Project Override: Project-level settings override defaults for specific projects
Directory-Specific: When you change directories, project settings are loaded automatically
Fallback Logic: Project model → User default model → System default (grok-code-fast-1)

This means you can have different models for different projects while maintaining consistent global settings like your API key.

Using Other API Providers

Important: Grok CLI uses OpenAI-compatible APIs. You can use any provider that implements the OpenAI chat completions standard.

Popular Providers:

X.AI (Grok): https://api.x.ai/v1 (default)
OpenAI: https://api.openai.com/v1
OpenRouter: https://openrouter.ai/api/v1
Groq: https://api.groq.com/openai/v1

Example with OpenRouter:

{
  "apiKey": "your_openrouter_key",
  "baseURL": "https://openrouter.ai/api/v1",
  "defaultModel": "anthropic/claude-3.5-sonnet",
  "models": [
    "anthropic/claude-3.5-sonnet",
    "openai/gpt-4o",
    "meta-llama/llama-3.1-70b-instruct"
  ]
}

Usage

Interactive Mode

Start the conversational AI assistant:

grok

Or specify a working directory:

grok -d /path/to/project

⌨️ Keyboard Shortcuts

Ctrl+I - Toggle context tooltip (workspace insights, git branch, project stats)
Shift+Tab - Toggle auto-edit mode (hands-free file editing)
Ctrl+C - Clear current input
Esc - Interrupt current operation
exit - Quit the application

Headless Mode

Process a single prompt and exit (useful for scripting and automation):

grok --prompt "show me the package.json file"
grok -p "create a new file called example.js with a hello world function"
grok --prompt "run bun test and show me the results" --directory /path/to/project
grok --prompt "complex task" --max-tool-rounds 50  # Limit tool usage for faster execution

This mode is particularly useful for:

CI/CD pipelines: Automate code analysis and file operations
Scripting: Integrate AI assistance into shell scripts
Terminal benchmarks: Perfect for tools like Terminal Bench that need non-interactive execution
Batch processing: Process multiple prompts programmatically

Tool Execution Control

By default, Grok CLI allows up to 400 tool execution rounds to handle complex multi-step tasks. You can control this behavior:

# Limit tool rounds for faster execution on simple tasks
grok --max-tool-rounds 10 --prompt "show me the current directory"

# Increase limit for very complex tasks (use with caution)
grok --max-tool-rounds 1000 --prompt "comprehensive code refactoring"

# Works with all modes
grok --max-tool-rounds 20  # Interactive mode
grok git commit-and-push --max-tool-rounds 30  # Git commands

Use Cases:

Fast responses: Lower limits (10-50) for simple queries
Complex automation: Higher limits (500+) for comprehensive tasks
Resource control: Prevent runaway executions in automated environments

Model Selection

You can specify which AI model to use with the --model parameter or GROK_MODEL environment variable:

Method 1: Command Line Flag

# Use Grok models
grok --model grok-code-fast-1
grok --model grok-4-latest
grok --model grok-3-latest
grok --model grok-3-fast

# Use other models (with appropriate API endpoint)
grok --model gemini-2.5-pro --base-url https://api-endpoint.com/v1
grok --model claude-sonnet-4-20250514 --base-url https://api-endpoint.com/v1

Method 2: Environment Variable

export GROK_MODEL=grok-code-fast-1
grok

Method 3: User Settings File Add to ~/.grok/user-settings.json:

{
  "apiKey": "your_api_key_here",
  "defaultModel": "grok-code-fast-1"
}

Model Priority: --model flag > GROK_MODEL environment variable > user default model > system default (grok-code-fast-1)

Command Line Options

grok [options]

Options:
  -V, --version          output the version number
  -d, --directory <dir>  set working directory
  -k, --api-key <key>    Grok API key (or set GROK_API_KEY env var)
  -u, --base-url <url>   Grok API base URL (or set GROK_BASE_URL env var)
  -m, --model <model>    AI model to use (e.g., grok-code-fast-1, grok-4-latest) (or set GROK_MODEL env var)
  -p, --prompt <prompt>  process a single prompt and exit (headless mode)
  --max-tool-rounds <rounds>  maximum number of tool execution rounds (default: 400)
  -h, --help             display help for command

Custom Instructions

You can provide custom instructions to tailor Grok's behavior to your project by creating a .grok/GROK.md file in your project directory:

mkdir .grok

Create .grok/GROK.md with your custom instructions:

# Custom Instructions for Grok CLI

Always use TypeScript for any new code files.
When creating React components, use functional components with hooks.
Prefer const assertions and explicit typing over inference where it improves clarity.
Always add JSDoc comments for public functions and interfaces.
Follow the existing code style and patterns in this project.

Grok will automatically load and follow these instructions when working in your project directory. The custom instructions are added to Grok's system prompt and take priority over default behavior.

Morph Fast Apply (Optional)

Grok CLI supports Morph's Fast Apply model for high-speed code editing at 4,500+ tokens/sec with 98% accuracy. This is an optional feature that provides lightning-fast file editing capabilities.

Setup: Configure your Morph API key following the setup instructions above.

How It Works

When MORPH_API_KEY is configured:

edit_file tool becomes available alongside the standard str_replace_editor
Optimized for complex edits: Use for multi-line changes, refactoring, and large modifications
Intelligent editing: Uses abbreviated edit format with // ... existing code ... comments
Fallback support: Standard tools remain available if Morph is unavailable

When to use each tool:

edit_file (Morph): Complex edits, refactoring, multi-line changes
str_replace_editor: Simple text replacements, single-line edits

Example Usage

With Morph Fast Apply configured, you can request complex code changes:

grok --prompt "refactor this function to use async/await and add error handling"
grok -p "convert this class to TypeScript and add proper type annotations"

The AI will automatically choose between edit_file (Morph) for complex changes or str_replace_editor for simple replacements.

MCP Tools

Grok CLI supports MCP (Model Context Protocol) servers, allowing you to extend the AI assistant with additional tools and capabilities.

Adding MCP Tools

Add a custom MCP server:

# Add an stdio-based MCP server
grok mcp add my-server --transport stdio --command "bun" --args server.js

# Add an HTTP-based MCP server
grok mcp add my-server --transport http --url "http://localhost:3000"

# Add with environment variables
grok mcp add my-server --transport stdio --command "python" --args "-m" "my_mcp_server" --env "API_KEY=your_key"

Add from JSON configuration:

grok mcp add-json my-server '{"command": "bun", "args": ["server.js"], "env": {"API_KEY": "your_key"}}'

Linear Integration Example

To add Linear MCP tools for project management:

# Add Linear MCP server
grok mcp add linear --transport sse --url "https://mcp.linear.app/sse"

This enables Linear tools like:

Create and manage Linear issues
Search and filter issues
Update issue status and assignees
Access team and project information

Managing MCP Servers

# List all configured servers
grok mcp list

# Test server connection
grok mcp test server-name

# Remove a server
grok mcp remove server-name

Available Transport Types

stdio: Run MCP server as a subprocess (most common)
http: Connect to HTTP-based MCP server
sse: Connect via Server-Sent Events

Development

# Install dependencies
npm install

# Development mode
bun run dev

# Build project
npm run build

# Run linter
bun run lint

# Type check
bun run typecheck

Pre-commit Hooks

This project uses Husky and lint-staged to run automated checks before commits:

ESLint: Automatically fixes linting issues and checks for errors
TypeScript: Runs type checking to prevent compilation errors
Staged files only: Only checks files that are staged for commit

The pre-commit hook runs npx lint-staged, which processes *.{ts,tsx} files with:

eslint --fix - Auto-fix linting issues where possible
tsc --noEmit - Type check without emitting files

If checks fail, the commit is blocked until issues are resolved.

🤖 Automated Release System

Status: ✅ FULLY AUTOMATED (as of 2025-10-17)

How It Works

Every push to the main branch automatically:

🔄 Bumps version (patch increment: 1.0.X → 1.0.X+1)
📝 Updates README with new version number
🏗️ Builds the project with fresh dependencies
📦 Publishes to NPM at https://www.npmjs.com/package/grok-cli-hurry-mode
🏷️ Creates git tag (e.g., v1.0.87)

⏱️ Timeline: ~3-5 minutes from push to NPM availability

What You Need to Do

Nothing! Just push your changes to main:

git add .
git commit -m "your feature/fix"
git push origin main
# ✨ Automation handles the rest!

🚨 Critical Dependencies

⚠️ DO NOT MODIFY without understanding the full impact:

GitHub Secrets (Required)

PAT_TOKEN: Personal Access Token with repo permissions (for git operations)
NPM_TOKEN: NPM Automation token from grok_cli account (for publishing)

Package Configuration (Sacred Settings)

{
  "name": "grok-cli-hurry-mode", // ⚠️ NEVER change - breaks publishing
  "publishConfig": {
    "access": "public" // ⚠️ Must NOT include registry override
  }
}

Workflow File (`.github/workflows/release.yml`)

⚠️ This took multiple attempts to get working - modify with extreme caution!

🔧 Manual Release (Emergency Only)

If automation fails and you need to publish immediately:

# 1. Bump version locally
npm version patch  # or minor/major

# 2. Test build
npm run build
npm run local  # Test CLI locally

# 3. Manual publish
npm publish --access public

# 4. Push changes
git push origin main --follow-tags

# 5. Fix automation before next release!

📊 Monitoring

GitHub Actions: https://github.com/hinetapora/grok-cli-hurry-mode/actions
NPM Package: https://www.npmjs.com/package/grok-cli-hurry-mode
Release History: Check git tags or NPM version history

🛠️ Troubleshooting

If automation fails:

Check GitHub Actions logs for specific errors
Verify secrets (PAT_TOKEN, NPM_TOKEN) haven't expired
Confirm package.json name hasn't been modified
See documentation: .agent/sop/npm-publishing-troubleshooting.md

Common Issues:

Build fails: Usually Rollup dependency cache (auto-fixed with clean install)
Publish fails: Check NPM token is valid and from correct account
Git push fails: Verify PAT_TOKEN has repo permissions

📚 Related Documentation

📋 Release Management: .agent/sop/release-management.md
🚨 Incident History: .agent/incidents/incident-npm-publish-failure.md
🔧 Troubleshooting: .agent/sop/npm-publishing-troubleshooting.md

Architecture

Agent: Core command processing and execution logic
Tools: Text editor and bash tool implementations
UI: Ink-based terminal interface components
Types: TypeScript definitions for the entire system

License

MIT

Credits

This project is based on grok-cli by @pelaseyed.

Troubleshooting

Installation Issues

🚨 "Command not found: grok"

# Check if grok is installed
npm list -g grok-cli-hurry-mode

# If installed but not in PATH, add npm global bin to PATH:
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# Verify it works
grok --version

🚨 "Permission denied" during installation

# Option 1: Use npx (no installation needed)
npx grok-cli-hurry-mode@latest

# Option 2: Fix npm permissions (macOS/Linux)
sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

# Option 3: Configure npm to use different directory
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

🚨 "Cannot find module" errors

# Clear npm cache and reinstall
npm cache clean --force
npm uninstall -g grok-cli-hurry-mode
npm install -g grok-cli-hurry-mode@latest

🚨 Outdated version

# Check current version
grok --version
npm view grok-cli-hurry-mode version

# Update to latest
npm update -g grok-cli-hurry-mode@latest

Tool Execution Errors

If you encounter errors like fs.readFile is not a function or fs.stat is not a function when using file operations:

This is a known issue with the tool infrastructure
Automatic fallback: The CLI will automatically fall back to bash commands for file operations
Warning messages: You may see console warnings like "str_replace_editor tool failed, falling back to bash"
Functionality: Despite the warnings, operations should still work via bash fallbacks

This issue is being tracked and the fallbacks ensure the CLI remains functional.

Runtime Issues

🚨 API Key errors

# Set your API key (replace with your actual key)
export GROK_API_KEY=your_actual_api_key_here

# Or add to your shell profile permanently
echo 'export GROK_API_KEY=your_actual_api_key_here' >> ~/.zshrc
source ~/.zshrc

# Verify it's set
echo $GROK_API_KEY

🚨 Network/connectivity issues

# Test with verbose output
grok --verbose "test message"

# Check API endpoint connectivity
curl -I https://api.x.ai/v1/models

Common Issues

File operations fail: Check that the file path exists and is accessible
Bash commands fail: Ensure you have the necessary permissions
Tool timeouts: Complex operations may take time; the spinner indicates progress
Slow responses: Try a different model with grok --model grok-code-fast-1

🙏 Credits

This project is built upon the excellent foundation of the original Grok CLI created by Ismail Pelaseyed at Superagent.ai.

Original Project: superagent-ai/grok-cli
Founder: Ismail Pelaseyed
Organization: Superagent.ai

This "Hurry Mode" fork extends the original with advanced file operations, enhanced tool systems, and comprehensive automation while maintaining the core vision of bringing AI-powered terminal intelligence to developers.

👥 Contributors

We welcome contributions from the community! Add your details below when you contribute to the project.

Core Contributors

@hinetapora — Fork maintainer, advanced tool systems, UX enhancements, auto-upgrade system
@homanp — Original Grok CLI creator and foundation

Community Contributors

@unblock-everything — x.ai — Cold-ass honkey 😎
@Bucko89 — GMA — Grinding daily
@base-buzz — Meta

Want to see your name here? Check out our Contributing Guide and submit a pull request!

How to Contribute

Fork the repository on GitHub
Clone your fork locally: git clone https://github.com/yourusername/grok-cli-hurry-mode.git
Create a feature branch: git checkout -b feature/your-feature-name
Make your changes and commit them: git commit -m "feat: add awesome feature"
Push to your fork: git push origin feature/your-feature-name
Submit a pull request with a clear description of your changes

Types of Contributions Welcome

🐛 Bug fixes - Help us squash those pesky bugs
⚡ Performance improvements - Make it faster and more efficient
📖 Documentation - Improve our docs and examples
🎨 UX/UI enhancements - Better terminal experience
🔧 New tools - Add new capabilities to the tool system
🧪 Tests - Help us improve our test coverage
💡 Feature requests - Suggest new functionality

Join our growing community of AI-powered terminal enthusiasts!

Name		Name	Last commit message	Last commit date
Latest commit History 360 Commits
.agent		.agent
.archive		.archive
.githooks		.githooks
.github		.github
.husky		.husky
apps/site		apps/site
data		data
dev		dev
dist		dist
docs		docs
scripts		scripts
src		src
.env.example		.env.example
.gitignore		.gitignore
.npmignore		.npmignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
claude.md		claude.md
eslint.config.mjs		eslint.config.mjs
grok-smart.sh		grok-smart.sh
hello.py		hello.py
homebrew-formula.rb		homebrew-formula.rb
install.sh		install.sh
logs.zip		logs.zip
package-lock.json		package-lock.json
package.json		package.json
page.tsx		page.tsx
plan.md		plan.md
plan2.md		plan2.md
pnpm-workspace.yaml		pnpm-workspace.yaml
quickfix.md		quickfix.md
susan.py		susan.py
susan_script.py		susan_script.py
test.py		test.py
tsconfig.json		tsconfig.json
tsup.config.ts		tsup.config.ts
tsup.debug.config.ts		tsup.debug.config.ts
tsup.node.config.ts		tsup.node.config.ts
vercel.json		vercel.json
ye.py		ye.py

License

utrumsit/utrumsit-grok-cli

Folders and files

Latest commit

History

Repository files navigation

1.1.35 – Paste Text Summary Feature

Grok CLI

🔗 Quick Links

🆕 What's New in v1.0+

🎯 P0: Plan Mode - Claude Code Parity (Latest)

🎨 P4: UX Refinement - Claude Code Feel

🧠 P3: Code Intelligence Tools

🚀 P2: Enhanced File Operations

🛠️ P1: Reliability & Workflow Enhancements

✨ Features

🎯 Plan Mode - Claude Code's Signature Feature

🧠 Claude Code-Level Intelligence

🚀 Advanced File Operations

🤖 Core AI Capabilities

🎨 Enhanced User Experience

📚 Documentation System

🌍 Installation & Setup

Installation

Prerequisites

🚀 Quick Start

🛠️ PATH Setup (If grok command not found)

⚡ Quick Start (One-liner)

Local Development

Setup

Custom Base URL (Optional)

Configuration Files

User-Level Settings (~/.grok/user-settings.json)

Project-Level Settings (.grok/settings.json)

How It Works

Using Other API Providers

Usage

Interactive Mode

⌨️ Keyboard Shortcuts

Headless Mode

Tool Execution Control

Model Selection

Command Line Options

Custom Instructions

Morph Fast Apply (Optional)

How It Works

Example Usage

MCP Tools

Adding MCP Tools

Add a custom MCP server:

Add from JSON configuration:

Linear Integration Example

Managing MCP Servers

Available Transport Types

Development

Pre-commit Hooks

🤖 Automated Release System

How It Works

What You Need to Do

🚨 Critical Dependencies

GitHub Secrets (Required)

Package Configuration (Sacred Settings)

Workflow File (.github/workflows/release.yml)

🔧 Manual Release (Emergency Only)

📊 Monitoring

🛠️ Troubleshooting

📚 Related Documentation

Architecture

License

Credits

Troubleshooting

Installation Issues

Tool Execution Errors

Runtime Issues

Common Issues

🙏 Credits

👥 Contributors

Core Contributors

Community Contributors

How to Contribute

🛠️ PATH Setup (If `grok` command not found)

User-Level Settings (`~/.grok/user-settings.json`)

Project-Level Settings (`.grok/settings.json`)

Workflow File (`.github/workflows/release.yml`)

Packages