ASKME-CLI

[!NOTE] Adoraríamos sua ajuda! Se você testar o askme-cli no Windows ou tiver correções de compatibilidade, PRs são muito bem-vindos👏.

Um servidor MCP (Model Context Protocol) que fornece interface de confirmação do usuário para assistentes de IA

简体中文 | 日本語

Por quê

Assistentes de IA frequentemente precisam de confirmação do usuário ou próximos passos, mas não há uma maneira simples de obter entrada do usuário durante conversas MCP.

Este projeto fornece um endpoint de confirmação pessoal via interface de terminal.

Como começar

Você precisará configurar seu cliente MCP para usar o ASKME-CLI.

Implante a configuração usando as instruções abaixo.

Configuração rápida com npx

# View help and configuration examples
npx askme-cli help

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

Configurar cliente MCP

Adicione ao arquivo de configuração do seu cliente MCP:

Cursor (.cursor/mcp_servers.json)

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

Outros clientes MCP

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

Desenvolvimento local

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

# Build and run
npm run build
npm run start

Como usar

Uma vez configurado, o assistente de IA pode usar a ferramenta ask_me para coletar confirmação do usuário:

1. O assistente de IA chama a ferramenta ask_me com um resumo do trabalho concluído
2. O ASKME-CLI abre uma nova janela de terminal com interface de confirmação
3. O usuário insere o próximo plano ou confirmação e envia
4. O assistente de IA recebe a entrada do usuário para continuar

Suporte a terminais

Configure via variável de ambiente ASKME_CLI_TERMINAL:

Terminal	Value	Description
Warp	warp	Padrão, aplicativo de terminal moderno
iTerm2	iterm2	Terminal macOS popular
Terminal	terminal	Terminal do sistema macOS
Kitty	kitty	Terminal multiplataforma
Alacritty	alacritty	Terminal acelerado por GPU
Hyper	hyper	Terminal baseado na web

Referência da API

Ferramenta ask_me

Coleta o próximo plano ou confirmação do usuário.

Parâmetros:

• what_we_did (string): Resumo do trabalho concluído pela IA

Retorna:

• Entrada do usuário para o próximo plano ou confirmação
• Suporta entrada de texto e imagem

Exemplos de uso

Integração com assistente de IA

Para usar o ASKME-CLI de forma eficaz no seu assistente de IA, adicione estas regras ao prompt do sistema:

- 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.

Exemplo de chamada de ferramenta

{
  "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."
  }
}

Pilha tecnológica

• TypeScript - Desenvolvimento com segurança de tipos
• React + Ink - Framework de interface de terminal
• MCP SDK - Suporte ao Model Context Protocol
• Node.js - Ambiente de execução

Licença

MIT