Sidekick CLI: una herramienta de código abierto para sustituir el código Claude

Introducción general

Sidekick CLI es una herramienta de línea de comandos de código abierto diseñada para simplificar el proceso de desarrollo y despliegue de proyectos para desarrolladores con asistencia de IA. Es compatible con Claude Código, Copiloto y Cursor El Sidekick CLI está inspirado en el Sidekick Language Model y proporciona una funcionalidad similar, pero permite a los usuarios elegir libremente un proveedor de Large Language Model (LLM) para evitar la dependencia de un proveedor.El Sidekick CLI ha sido diseñado con un diseño "CLI-first" y soporta servidores Model Context Protocol (MCP) para ampliar las capacidades de interacción AI.El Sidekick CLI ha sido diseñado con un diseño "CLI-first" y soporta servidores Model Context Protocol (MCP). Sidekick CLI tiene un diseño "CLI-first" y admite servidores de Protocolo de contexto de modelo (MCP) para ampliar las capacidades de interacción de IA. Es ideal para que los desarrolladores independientes o los equipos pequeños configuren rápidamente los proyectos, los desplieguen en VPS y proporcionen generación de código y soporte de depuración a través de la IA. El proyecto está actualmente en Beta, alojado en GitHub, mantenido por el desarrollador Gavin Vickery (geekforbrains), bajo licencia MIT, y agradece las contribuciones y comentarios de la comunidad.

Lista de funciones

• Desarrollo asistido por IAGeneración de código, depuración de problemas o consulta de documentación con sugerencias en lenguaje natural y compatibilidad con varios proveedores de LLM.
• Cambio flexible de modeloPermite cambiar sin problemas entre distintos modelos de IA en la misma sesión para adaptarse a los distintos requisitos de las tareas.
• Compatibilidad con servidores MCPConéctate a herramientas y fuentes de datos externas para mejorar las capacidades de IA, como la recuperación de código de GitHub.
• Documento de orientación del proyecto: a través de SIDEKICK.md Personalice la pila tecnológica y las preferencias de desarrollo del proyecto.
• Despliegue de VPS en un clicConfigure automáticamente su entorno VPS, instale Docker y Traefik, y soporte dominios HTTPS.
• Función de deshacer: Uso /undo Deshaga rápidamente los cambios incorrectos causados por la IA.
• Seguimiento de costes y fichasControla los costes de uso de LLM y el consumo de tokens y establece límites presupuestarios.
• control telemétrico: a través de --no-telemetry Desactivar el seguimiento de errores y el análisis de uso de Sentry.
• Control de acuse de recibo de comandos: Apoyo /yolo Modo Omitir Confirmación, o pulse Ajuste Sesión para confirmar el ajuste.

Utilizar la ayuda

Proceso de instalación

El Sidekick CLI es fácil de instalar, y es compatible con el uso de la pip o instalación del código fuente. A continuación se detallan los pasos a seguir:

1. Comprobar los requisitos del sistema
   Asegúrese de que Python 3.8+ y la aplicación pipSe recomienda a los usuarios de Windows que instalen Git Bash o WSL para disfrutar de una mejor experiencia con el terminal. Los usuarios de macOS y Linux no necesitan ninguna configuración adicional.
2. Instalación mediante pip
   Ejecute el siguiente comando para instalar la CLI de Sidekick:

   pip install sidekick-cli

Una vez finalizada la instalación, compruebe la versión:

sidekick --version

3. Instalación desde el origen(para desarrolladores)
   Clonar un repositorio GitHub:

   git clone https://github.com/geekforbrains/sidekick-cli.git
   cd sidekick-cli
   

   Instale la dependencia:

   pip install .
   

   Si se requiere el modo de desarrollo (los cambios en el código surten efecto en tiempo real), ejecútelo:

   pip install -e .
   

4. configuración inicial
   Ejecute la CLI de Sidekick por primera vez:

   sidekick
   

   El sistema solicita que se configure el proveedor de LLM (por ejemplo, OpenAI, Anthropic). La información de configuración se almacena en la carpeta ~/.config/sidekick.json. Ejemplo de configuración:

   {
   "llm_providers": {
   "openai": {
   "api_key": "<你的API密钥>",
   "model": "gpt-4"
   }
   },
   "mcpServers": {
   "fetch": {
   "command": "uvx",
   "args": ["mcp-server-fetch"]
   }
   }
   }
   

   Puede editar manualmente el archivo para añadir más proveedores LLM o MCP Servidor.

5. Verificar la instalación
   Ejecute el siguiente comando para confirmar que la CLI de Sidekick funciona correctamente:

   sidekick --version
   

   Si se devuelve el número de versión (por ejemplo 0.1.0), la instalación se ha realizado correctamente.

Guía de funcionamiento

1. Desarrollo asistido por IA

La función principal de Sidekick CLI es el desarrollo asistido por IA. Ejecute el siguiente comando para generar código:

sidekick generate --prompt "编写一个 Flask REST API"

La IA genera el código cuando se le pide y lo guarda en un archivo especificado. También puedes depurar el código:

sidekick debug --file app.py

Este comando analiza el código, señala errores y sugiere correcciones. Si las modificaciones de la IA causan problemas, puedes utilizar la función deshacer:

sidekick /undo

Deshacer restaura los cambios más recientes y es bueno para corregir errores rápidamente.

2. Cambio de modelo flexible

La CLI de Sidekick permite cambiar de modelo de IA dentro de una sesión. Ver los modelos disponibles:

sidekick /model

Ejemplo de salida:

0: gpt-4 (OpenAI)
1: claude-3 (Anthropic)

Cambia a un modelo específico:

sidekick /model 0

Esta función es adecuada para seleccionar un modelo más apropiado según los requisitos de la tarea.

3. Soporte del servidor MCP

El servidor MCP amplía las capacidades de la CLI de Sidekick. Por ejemplo, configure el servidor MCP de GitHub para recuperar código:

{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<你的GitHub令牌>"
}
}
}
}

Después de guardar, ejecute el siguiente comando para probar la función MCP:

sidekick fetch --repo <GitHub仓库地址>

El servidor MCP ofrece a la IA acceso directo a fuentes de datos externas, lo que mejora la generación y el análisis de códigos.

4. Documento de orientación del proyecto

La CLI de Sidekick admite la creación del archivo SIDEKICK.md que define la pila tecnológica del proyecto y las preferencias de desarrollo. Ejemplo SIDEKICK.md::

# Sidekick Guide
- Tech Stack: Python, Flask, PostgreSQL
- Coding Style: PEP 8
- Project Structure: MVC
- Preferred LLM: gpt-4

Una vez creado, la CLI de Sidekick ajusta el comportamiento de la IA basándose en este archivo. Ejecute el siguiente comando para aplicar la guía:

sidekick init

5. Instalación de VPS con un solo clic

Sidekick CLI simplifica el despliegue de VPS para sistemas Ubuntu 20.04+. Ejecute el siguiente comando:

sidekick deploy --vps <VPS_IP地址>

La CLI del Sidekick lo hará automáticamente:

• Configure SSH y los permisos de usuario.
• Instala Docker y Traefik.
• Establecer HTTPS (utilizado por defecto) sslip.io (nombre de dominio gratuito).
  Compruebe el estado del despliegue:

sidekick status

Actualice la aplicación:

sidekick deploy --update

Esta función permite una implantación sin tiempo de inactividad y es adecuada para proyectos de puesta en marcha rápida.

6. Seguimiento de costes y fichas

La CLI de Sidekick permite supervisar el uso de LLM. Vea el consumo actual:

sidekick cost

El resultado incluye el recuento de fichas y la estimación de costes. Establezca el presupuesto:

sidekick cost --set-budget 20.0

El Sidekick CLI avisa cuando los costes se acercan al presupuesto.

7. Control de telemetría

La CLI de Sidekick activa la telemetría Sentry de forma predeterminada para recopilar datos de errores y de uso. Desactive la telemetría:

sidekick --no-telemetry

Este comando garantiza que los usuarios sensibles a la privacidad puedan desactivar completamente la recopilación de datos.

8. Control de acuse de recibo de órdenes

Para acelerar la operación, active el modo "yolo" para saltarse la confirmación:

sidekick /yolo

Confirmación de restauración:

sidekick /yolo off

También puede establecer el comportamiento por defecto mediante un archivo de configuración:

{
"skip_confirm": true
}

Comandos comunes

• /helpMuestra todos los comandos.
• /clearBorra el historial de mensajes.
• /compact: Resume el historial de mensajes y borra los registros antiguos.
• /dumpMuestra el historial de mensajes actual (para depuración).
• exitSalga de la CLI de Sidekick.

advertencia

• Seguridad de las claves APIPara garantizar que ~/.config/sidekick.json La clave no está comprometida en el
• Requisitos del VPS: La implantación requiere puertos SSH abiertos (por defecto 22) e IP públicas.
• Límite de la fase betaPuede haber errores en la versión actual, así que no pierdas de vista el repositorio de GitHub para las actualizaciones.

escenario de aplicación

1. Creación rápida de prototipos
   Los desarrolladores necesitan crear prototipos de aplicaciones web con rapidez. La CLI de Sidekick genera código y automatiza la configuración mediante IA, llevando el proceso de la idea a la implantación en cuestión de días.
2. Implantación de VPS de bajo coste
   Para los equipos pequeños que deseen ejecutar aplicaciones en VPS de bajo presupuesto, la CLI de Sidekick ofrece un despliegue con un solo clic y seguimiento de costes para garantizar un uso eficiente de los recursos.
3. Aprendizaje basado en IA
   Los principiantes aprenden nuevos frameworks con las funciones de IA de la CLI de Sidekick. Introduzca indicaciones en lenguaje natural para generar código de ejemplo y depure para comprender la lógica.

CONTROL DE CALIDAD

1. ¿Es necesario que el Sidekick CLI esté siempre conectado?
   Sí, la funcionalidad de IA depende de la API del proveedor de LLM y requiere una conexión de red.Los despliegues de servidores MCP y VPS también requieren una conexión de red.
2. ¿Cómo desactivo la telemetría?
   estar en movimiento sidekick --no-telemetry o en sidekick.json establecer "telemetry": false.
3. ¿Qué proveedores de LLM son compatibles?
   Actualmente es compatible con OpenAI, Anthropic, etc., y se añadirá en el futuro. Ollama y otros modelos locales (véase la hoja de ruta).
4. ¿Cómo puedo contribuir con código?
   Clone el repositorio e instale las dependencias de desarrollo (make install), envíe la Pull Request a GitHub.