English 中文 العربية 日本語 Português

Pi Agent: CLI Reference & Slash Commands

Última atualização: 2026-08-31

--- title: "Referencia CLI e Comandos com Barra" description: "Referencia completa da CLI do Pi Agent incluindo todos os comandos, opcoes, comandos com barra e exemplos de uso." order: 19 lang: pt-br

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

📝 Exercícios

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

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.

100%