Pi Agent: Keybindings & Theme Customization
Última atualização: 2026-08-31
--- title: "Atalhos de Teclado e Personalizacao de Tema" description: "Personalize os atalhos de teclado e temas de UI do Pi Agent para construir seu ambiente ideal de desenvolvimento de Agent." order: 9 lang: pt-br
Ferramentas se sentem certas quando se ajustam às suas mãos. Atalhos e temas são a "calibração da sua estação de trabalho."
1. Atalhos de Teclado
(1) Atalhos Padrão
| Atalho | Função |
|---|---|
| Ctrl+C | Interromper operação atual / Sair |
| Ctrl+D | Sair do modo interativo |
| Enter | Enviar mensagem |
| Ctrl+L | Limpar tela |
| Tab | Autocompletar (comandos/nomes de arquivo) |
| Up/Down | Navegar no histórico de mensagens |
| Ctrl+R | Regenerar última resposta |
| Ctrl+E | Editar última mensagem |
| Ctrl+K | Deletar até o fim da linha |
(2) Atalhos Personalizados
Configure em ~/.pi-agent/keybindings.yaml:
YAML
keybindings:
submit: "enter"
new_line: "ctrl+enter"
clear_screen: "ctrl+l"
retry: "ctrl+r"
edit_last: "ctrl+e"
save_session: "ctrl+s"
load_session: "ctrl+o"
toggle_tools: "ctrl+t"
switch_model: "ctrl+m"
history_up: "up"
history_down: "down"
(3) Registrar Atalhos no Código
PYTHON
from pi_agent import Agent
agent = Agent(name="custom")
@agent.keybind("ctrl+shift+r")
def retry_with_reasoner():
agent.switch_model("deepseek-reasoner")
agent.retry()
@agent.keybind("ctrl+shift+s")
def save_and_summarize():
agent.session.save("auto_save.json")
print("Session saved")
2. Personalização de Tema
(1) Temas Integrados
BASH
pi-agent config set theme dark
pi-agent config set theme light
pi-agent config set theme monokai
pi-agent config set theme solarized
pi-agent config set theme nord
(2) Trocar no Modo Interativo
TEXT
📖 Somente leitura
you> /theme dark
Theme switched to dark
(3) Tema Personalizado
Crie ~/.pi-agent/themes/my_theme.yaml:
YAML
name: my_theme
background: "#1e1e2e"
foreground: "#cdd6f4"
accent: "#89b4fa"
error: "#f38ba8"
warning: "#fab387"
success: "#a6e3a1"
user_input: "#89dceb"
agent_output: "#cdd6f4"
tool_call: "#f9e2af"
code_block:
background: "#313244"
foreground: "#cdd6f4"
keyword: "#cba6f7"
string: "#a6e3a1"
comment: "#6c7086"
function: "#89b4fa"
Aplique:
BASH
pi-agent config set theme my_theme
3. Personalização de Formato de Saída
(1) Destaque de Código
YAML
display:
code_highlight: true
code_theme: "monokai"
line_numbers: true
wrap_lines: false
(2) Renderização Markdown
YAML
display:
markdown_render: true
table_render: true
link_clickable: true
(3) Exibição de Chamadas de Ferramentas
YAML
display:
show_tool_calls: true
tool_call_format: "compact" # compact | detailed | minimal
show_thinking: false
4. Fonte e Layout
YAML
display:
font_family: "JetBrains Mono"
font_size: 14
line_height: 1.5
show_header: true
show_token_count: true
show_timestamp: false
compact_mode: false
max_width: 120
❓ Perguntas Frequentes
P: Conflitos de atalhos? R: Os atalhos do Pi Agent têm prioridade menor que os atalhos do terminal. Se houver conflito, modifique a configuração de atalhos do Pi Agent. P: Tema não está aplicando? R: Certifique-se de que o nome do arquivo do tema corresponde à configuração. Temas personalizados devem estar em
~/.pi-agent/themes/. P: Problemas de exibição de emoji no terminal? R: Certifique-se de que seu terminal suporta Unicode. Windows Terminal, iTerm2 e Alacritty suportam. O antigo cmd.exe pode não suportar.
❓ Resumo
- Atalhos padrão cobrem operações comuns; personalizáveis em keybindings.yaml
- 5 temas integrados; esquemas de cores totalmente personalizáveis suportados
- Formato de saída configurável: destaque de código, renderização Markdown, exibição de chamadas de ferramentas
- Opções de fonte e layout otimizam a experiência de leitura
📝 Exercícios
- Básico (Dificuldade: ⭐): Alterne entre 3 temas integrados, escolha seu favorito.
- Intermediário (Dificuldade: ⭐⭐): Crie um tema personalizado com seu esquema de cores preferido.
- Avançado (Dificuldade: ⭐⭐⭐): Registre atalhos para alternância com uma tecla entre os temas "modo de codificação" e "modo de leitura".
