O que cli-anything-seaclip faz?
Uma interface de linha de comando sem estado para gerenciamento de projetos SeaClip-Lite. Comunica-se via API HTTP e leituras diretas de SQLite. Sem estado local ou sessão.
Instalação
pip install -e .
Pré-requisitos:
- Python 3.10+
- Backend SeaClip-Lite em execução em localhost:5200
Uso
Comandos Básicos
# Mostrar ajuda
cli-anything-seaclip --help
# Iniciar modo REPL interativo
cli-anything-seaclip
# Executar com saída JSON (para consumo por agentes)
cli-anything-seaclip --json server health
cli-anything-seaclip --json issue list
cli-anything-seaclip --json agent list
Modo REPL
Quando invocado sem um subcomando, a CLI entra em uma sessão REPL interativa:
cli-anything-seaclip
# Insira comandos interativamente com autocompletar e histórico
Grupos de Comandos
Issue
Comandos de gerenciamento de issues.
| Comando | Descrição |
|---|---|
list | Listar issues (--status, --priority, --search, --limit) |
create | Criar nova issue (--title, --description, --priority) |
move | Mover issue para coluna (ISSUE_ID --column COL) |
status | Atualizar status da issue (ISSUE_ID --set STATUS) |
delete | Excluir uma issue (ISSUE_ID) |
Agent
Comandos de agente de pipeline.
| Comando | Descrição |
|---|---|
list | Listar todos os agentes de pipeline |
Pipeline
Comandos de controle de pipeline.
| Comando | Descrição |
|---|---|
start | Iniciar pipeline (--issue UUID --mode auto/manual) |
status | Obter status do pipeline (--issue UUID) |
resume | Retomar pipeline pausado (--issue UUID) |
stop | Parar pipeline em execução (--issue UUID) |
Scheduler
Comandos de configuração de agendamento.
| Comando | Descrição |
|---|---|
list | Listar todas as configurações de agendamento |
add | Adicionar agendamento (--name, --cron, --repo) |
sync | Acionar sincronização (SCHEDULE_ID) |
Activity
Comandos do feed de atividades.
| Comando | Descrição |
|---|---|
list | Atividade recente (--limit N) |
Server
Comandos utilitários do servidor.
| Comando | Descrição |
|---|---|
health | Verificar saúde do backend |
Formatos de Saída
Todos os comandos suportam dois modos de saída:
- Legível por humanos (padrão): Tabelas, cores, texto formatado
- Legível por máquina (flag
--json): JSON estruturado para consumo por agentes
# Saída humana
cli-anything-seaclip issue list
# Saída JSON para agentes
cli-anything-seaclip --json issue list
Para Agentes de IA
Ao usar esta CLI programaticamente:
- Sempre use a flag
--jsonpara saída parseável - Verifique códigos de retorno - 0 para sucesso, não-zero para erros
- Analise o stderr para mensagens de erro em caso de falha
- Respostas de erro incluem
{"error": "message"}no modo JSON
Versão
1.0.0