cli

lark-cli es la interfaz de línea de comandos oficial para Lark/Feishu, mantenida por el equipo de larksuite. Está diseñada tanto para usuarios humanos como para agentes de IA, cubriendo 18 dominios empresariales principales, incluyendo Mensajería, Documentos, Base, Hojas, Presentaciones, Calendario, Correo, Tareas, Reuniones, Markdown, Wiki, Contactos, Asistencia, Aprobaciones, OKR, Proyectos y Aplicaciones, con más de 200 comandos seleccionados y 26 habilidades de agente de IA. La herramienta presenta un diseño nativo para agentes con habilidades estructuradas compatibles con herramientas de IA populares, permitiendo que los agentes operen Lark sin configuración adicional. Cada comando se prueba con agentes reales, con parámetros concisos, valores predeterminados inteligentes y salida estructurada para maximizar las tasas de éxito de llamadas de agentes. Es de código abierto bajo la licencia MIT y se puede instalar mediante npm en solo unos pocos pasos. El sistema de comandos de tres capas proporciona flexibilidad a diferentes granularidades: Atajos (prefijados con +, diseñados para humanos e IA con valores predeterminados inteligentes y salida tabular), Comandos API (generados automáticamente a partir de metadatos de Lark OAPI, seleccionados mediante evaluación y puertas de calidad, con más de 100 comandos mapeados 1:1 a endpoints de plataforma) y Llamadas API Crudas (acceso directo a cualquier endpoint de la Plataforma Abierta de Lark, cubriendo más de 2500 APIs). La autenticación admite inicio de sesión OAuth con selección interactiva o banderas de CLI para ámbitos, cambio de identidad entre usuario y bot, y modo agente con URLs de verificación no bloqueantes. La herramienta incluye múltiples formatos de salida (JSON, pretty, table, ndjson, CSV), soporte de paginación, vistas previas en seco para comandos con efectos secundarios e introspección de esquemas para inspeccionar parámetros de API y estructuras de respuesta. Las características de seguridad incluyen protección contra inyección de entrada, saneamiento de salida de terminal, almacenamiento de credenciales en llavero nativo del sistema operativo y señales de control de riesgo enviadas con solicitudes de OpenAPI a dominios HTTPS oficiales de Feishu/Lark. La herramienta advierte a los usuarios sobre riesgos inherentes cuando los agentes de IA automatizan operaciones, incluyendo alucinaciones de modelos, ejecución impredecible e inyección de prompts, y recomienda usar el bot integrado como asistente conversacional privado en lugar de en chats grupales. Para uso empresarial, la herramienta admite integración en agentes o plataformas personalizados con credenciales centralizadas, registro de auditoría unificado y una superficie de comandos restringida mediante paquetes de extensión. El proyecto está escrito en Go (v1.23+) y se distribuye mediante npm, con contribuciones de la comunidad bienvenidas bajo la Licencia MIT.