ccom

Claude Command

Convert natural language to shell commands using Claude AI. Describe what you want, pick from suggested commands, and run them instantly.

GitHub Get Started
curl -o /usr/local/bin/ccom ... && chmod +x /usr/local/bin/ccom 
 

Features

Natural Language

Describe what you want in plain English. Claude AI translates your intent into the right shell command.

Smart Caching

Repeated prompts return instant cached results. No API calls wasted on commands you've already asked for.

Multiple Options

Get 1–3 command suggestions ranked by relevance. Pick the one that fits, then run it directly.

Command History

Every executed command is logged to ~/.ccom/history.jsonl for review and auditing.

Fresh Mode

Use the -f flag to bypass cache and generate new suggestions when you need different options.

Interactive UI

Clean terminal interface with numbered options, color-coded output, and one-keystroke execution.

Getting Started

1

Install ccom

Requires Claude CLI installed and authenticated.

curl -o /usr/local/bin/ccom https://raw.githubusercontent.com/doublej/ccom/main/ccom
chmod +x /usr/local/bin/ccom
2

Run your first command

Describe what you want to do and pick from the suggested commands.

ccom "list all files sorted by size"

Usage

Basic

ccom "find large videos"

Describe what you want in plain English.

Fresh mode

ccom -f "list files"

Bypass cache and get new suggestions.

Multi-word prompts

ccom compress this folder

Quotes are optional for multi-word prompts.

How It Works

1

You describe a task in natural language

→
2

Claude AI generates 1–3 shell command options

→
3

You pick one and it runs immediately

Data is stored locally in ~/.ccom/:

  • cache.json — cached prompt results
  • history.jsonl — full command history log