Back
Projects/ask-cli
Fun buildRole: Personal

ask-cli

ask is a small terminal assistant that generates shell commands from plain language using your current environment context.

Node.jsOpenAI APICLIChalk
Case narrative

Problem

I wanted a fast way to turn ideas into exact shell commands without losing context.

Solution

Built a CLI assistant that captures environment context and returns executable commands.

Impact

Speeds up terminal workflows while keeping command history and shareable snippets.

Highlights
  • Generates commands with context (OS, shell, cwd, files, git status).
  • ask and ask explain modes for command creation or explanations.
  • History log stored in ~/.ask-cli/history.json.
  • Clipboard support with optional cmdbook integration via --save.
  • Supports OPENAI_API_KEY or ASK_CLI_API_KEY.
Build path

Timeline coming soon. Reach out for a live walkthrough.

Stack
Node.jsOpenAI APICLIChalk
Links and next steps
LiveBook a walkthrough