Skip to main content
Glama
askme-cli
by rhyspenn
NOTE

We'd love your help! If you try askme-cli on Windows or have compatibility fixes, PRs are very welcome👏.

npm GitHub license GitHub stars npm downloads

ASKME-CLI

🤖 💬 ⚡ 🚀 ✨

An MCP (Model Context Protocol) server that provides user confirmation interface for AI assistants

简体中文 | 日本語

Why

AI assistants often need user confirmation or next steps, but there's no simple way to get user input during MCP conversations.

This project provides a personal confirmation endpoint via terminal interface.

Related MCP server: MCP Terminal

How to start

You will need to configure your MCP client to use ASKME-CLI.

Deploy the configuration using the instructions below.

Quick Setup with npx

# View help and configuration examples
npx askme-cli help

# Run directly (when called by MCP client)
npx askme-cli

Configure MCP Client

Add to your MCP client configuration file:

Cursor (.cursor/mcp_servers.json)

{
  "mcpServers": {
    "askme-cli": {
      "command": "npx",
      "args": ["askme-cli"],
      "env": {
        "ASKME_CLI_TERMINAL": "warp"
      }
    }
  }
}

Other MCP Clients

{
  "mcpServers": {
    "askme-cli": {
      "command": "npx",
      "args": ["askme-cli"],
      "env": {
        "ASKME_CLI_TERMINAL": "iterm2"
      }
    }
  }
}

Local Development

# Clone and install
git clone <your-repo-url>
cd askme-cli
npm install

# Build and run
npm run build
npm run start

How to use

Once configured, the AI assistant can use the ask_me tool to collect user confirmation:

  1. AI assistant calls ask_me tool with summary of completed work

  2. ASKME-CLI opens a new terminal window with confirmation interface

  3. User enters next plan or confirmation and submits

  4. AI assistant receives user input to continue

Terminal Support

Configure via ASKME_CLI_TERMINAL environment variable:

Terminal

Value

Description

Warp

warp

Default, modern terminal app

iTerm2

iterm2

Popular macOS terminal

Terminal

terminal

macOS system terminal

Kitty

kitty

Cross-platform terminal

Alacritty

alacritty

GPU-accelerated terminal

Hyper

hyper

Web-based terminal

API Reference

ask_me Tool

Collects user's next plan or confirmation.

Parameters:

  • what_we_did (string): Summary of work completed by AI

Returns:

  • User's input for next plan or confirmation

  • Supports text and image input

Usage Examples

AI Assistant Integration

To use ASKME-CLI effectively in your AI assistant, add these rules to your system prompt:

- Must call the askme-cli.ask_me tool before ending any user prompt every time.
- All prompts starting with /tk, don't modify code or files, and call the askme-cli.ask_me tool before ending.
- When you have questions, always call the askme-cli.ask_me tool before ending.
- If you have ideas for new features or changes, explain them clearly, analyze their feasibility, and ask if I want to proceed.

Example Tool Call

{
  "tool": "ask_me",
  "parameters": {
    "what_we_did": "I've completed setting up the database schema and created the user authentication endpoints. The API is now ready for testing."
  }
}

Tech Stack

  • TypeScript - Type-safe development

  • React + Ink - Terminal UI framework

  • MCP SDK - Model Context Protocol support

  • Node.js - Runtime environment

License

MIT

Available Tools

1 tool
ask_meC

Ask the user for their next plan or obtain the user's confirmation

Inputs: what_we_did (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusion or overlap.

    Naming Consistency5/5

    With a single tool, naming consistency is not applicable, and 'ask_me' is a clear verb phrase.

    Tool Count3/5

    A single tool is borderline for the server's purpose; while it might be sufficient for a singular action, it feels thin.

    Completeness3/5

    The tool covers asking the user for plans or confirmation, but there are no additional tools for other interactions, making the surface minimal.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      A server that enables AI assistants to execute terminal commands and retrieve outputs via the Model Context Protocol (MCP).
      3
      26
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server implementing AI-user confirmation protocols, providing tools for LLMs to seek user confirmation when uncertain through yes/no questions, action confirmations, intent clarification, understanding verification, and satisfaction ratings.
      8
      10 npm
      MIT