Pi Agent: Referencia CLI e Comandos com Barra

Última atualização: 2026-10-13

A CLI é o "cockpit" do Pi Agent — conheça seus comandos, assuma o controle.

1. Opções Globais

BASH

pi-agent [options] [command]

Options:
  --version          Show version
  --help             Show help
  --config <path>    Specify config file path
  --verbose          Verbose output
  --quiet            Quiet mode
  --debug            Debug mode

2. Comandos Principais

(1) chat - Chat Interativo

BASH

pi-agent chat [options] [message]

Options:
  --provider <name>    Specify LLM provider
  --model <name>       Specify model
  --skill <name>       Load skill
  --system <prompt>    System prompt
  --session <name>     Restore session
  --context <file>     Load context file
  --sandbox            Enable sandbox mode

(2) run - Execução Não-Interativa

BASH

pi-agent run [options] <prompt>

Options:
  --input <file>       Read input from file
  --output <file>      Output to file
  --format <type>      Output format (text|json|markdown)
  --skill <name>       Use skill
  --stream             Stream output
  --timeout <seconds>  Timeout

(3) config - Gerenciamento de Configuração

BASH

pi-agent config set <key> <value>
pi-agent config get <key>
pi-agent config list
pi-agent config validate

3. Comandos de Ferramentas e Skills

(1) skills

BASH

pi-agent skills list
pi-agent skills show <name>
pi-agent skills create <name>
pi-agent skills install <package>
pi-agent skills remove <name>

(2) tools

BASH

pi-agent tools list
pi-agent tools show <name>
pi-agent tools test <name>

(3) ext

BASH

pi-agent ext list
pi-agent ext install <name>
pi-agent ext update <name>
pi-agent ext remove <name>
pi-agent ext create <name>
pi-agent ext publish <name>

4. Comandos de Sessão

BASH

pi-agent sessions list
pi-agent sessions show <name>
pi-agent sessions delete <name>
pi-agent sessions export <name>
pi-agent sessions search <query>

5. Comandos de Pacote

BASH

pi-agent pkg search <query>
pi-agent pkg install <name>
pi-agent pkg update [name]
pi-agent pkg remove <name>
pi-agent pkg list
pi-agent pkg info <name>
pi-agent pkg build <name>
pi-agent pkg validate <name>
pi-agent pkg publish <name>

6. Comandos com Barra (Modo Interativo)

Comando	Descrição	Exemplo
/help	Mostrar ajuda	/help
/exit	Sair	/exit
/clear	Limpar conversa	/clear
/model	Trocar modelo	/model deepseek-reasoner
/provider	Trocar provedor	/provider openai
/tools	Listar ferramentas	/tools
/use	Habilitar ferramenta	/use shell
/unuse	Desabilitar ferramenta	/unuse search
/skill	Carregar skill	/skill code_review
/save	Salvar sessão	/save session.json
/load	Carregar sessão	/load session.json
/context	Mostrar contexto	/context
/history	Mostrar histórico	/history
/retry	Regenerar	/retry
/edit	Editar última mensagem	/edit
/theme	Trocar tema	/theme dark
/trust	Definir confiança	/trust readonly
/cost	Estatísticas de custo	/cost
/branch	Criar ramificação	/branch experiment

7. Exemplos de Combinações Comuns

Exemplo 1: Workflow de Revisão de Código (Dificuldade: ⭐)

BASH

pi-agent chat --skill code_review --system "You are a Python expert"
# In interactive mode:
# /use file_reader
# /use search
# Review main.py code quality
# /save review_20260828.json
# /exit

Exemplo 2: Processamento em Lote via Pipe (Dificuldade: ⭐⭐)

BASH

find . -name "*.py" -exec echo {} \; | pi-agent run --skill code_review "Review file list"

❓ Perguntas Frequentes

P Muitos comandos para lembrar?

R Digite /help no modo interativo para comandos com barra. Use pi-agent --help para comandos globais.

P Abreviações de comandos?

R Alguns comandos suportam abreviações: pi-agent c = pi-agent chat, pi-agent r = pi-agent run.

P Saída JSON para scripts?

R Adicione --format json: pi-agent run "question" --format json.

❓ Resumo

CLI principal: chat, run, config
Gerenciamento: skills, tools, ext, sessions, pkg
20+ comandos com barra para modo interativo
Saída JSON suportada para integração com scripts

📝 Exercícios

Básico (Dificuldade: ⭐): Complete: criar sessão → conversar 3 rodadas → salvar → recarregar.
Intermediário (Dificuldade: ⭐⭐): Use pi-agent run com pipes para revisar em lote arquivos Python.
Avançado (Dificuldade: ⭐⭐⭐): Escreva um script shell combinando comandos CLI comuns do Pi Agent para revisão+correção+teste com um clique.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós