Configuração

O Pontia lê sua configuração persistente de $PONTIA_HOME/config.toml. PONTIA_HOME tem $HOME/.pontia como padrão e deve ser um caminho absoluto que não seja a raiz e não contenha ...

Depois de editar configurações persistentes do serviço, aplique-as com:

pontia up

Configuração básica

bind_addr = "127.0.0.1:8080"
external_api_token = "replace-with-a-long-secret"
run_migrations = true
default_client_type = "pi"

[runtime.pi]
tui_command = "pi"

[workspace_browser]
roots = [
  { root_id = "projects", label = "Projects", path = "/home/me/projects" }
]

Chave	Significado
`bind_addr`	Endereço local de escuta HTTP; o padrão é `127.0.0.1:8080`
`external_api_token`	Token Bearer exigido pelo Dashboard local e pela External API
`run_migrations`	Se o `pontiad` aplica as migrações de banco de dados incluídas; o padrão é `true`
`default_client_type`	Identificador do Client padrão; o valor suportado atualmente é `pi`
`dashboard.source`	Diretório de build do Dashboard local ou arquivo remoto `.tar.gz`, `.tgz` ou `.zip` contendo exatamente um `index.html`
`runtime.pi.tui_command`	Executável ou comando do pi usado nas Sessions do pi iniciadas
`runtime.codex.tui_command`	Executável do Codex usado ao abrir uma Session do Codex na TUI nativa; o padrão é `codex`
`acp.agents.ID`	Uma entrada de agente ACP; veja Agent Clients
`workspace_browser.roots`	Diretórios que o Dashboard pode navegar para ativar Workspaces

O padrão de dashboard.source na versão de release é o arquivo do Dashboard correspondente à versão instalada do Pontia. Arquivos remotos do Dashboard ficam em cache em $PONTIA_HOME/cache/dashboard; um cache existente ainda pode ser servido se a atualização falhar.

Seletor de arquivos

O seletor de arquivos alimenta as sugestões de @ dentro de uma Workspace ativa:

[file_picker]
enabled = true
min_query_chars = 0
max_results = 100
max_candidates = 100000
timeout_ms = 1500
respect_gitignore = true
respect_ignore_files = true
respect_git_exclude = true
include_hidden = false
follow_symlinks = false
ignore_globs = [
  ".git/**",
  "node_modules/**",
  "target/**",
  "dist/**",
  "build/**",
  ".svelte-kit/**",
  ".next/**"
]

Defina follow_symlinks = true para incluir nas buscas os destinos de symlinks acessíveis, inclusive destinos fora da árvore de diretórios visível.

Arquivos enviados

Os arquivos enviados são excluídos automaticamente após o período de retenção, contado a partir do início do envio. Guarde na sua Workspace os arquivos de que você precisa por mais tempo antes que eles expirem.

[uploads]
incomplete_retention_days = 7
completed_retention_days = 30
cleanup_interval_hours = 24

Estes são os padrões. Os três valores devem ser inteiros positivos. A limpeza roda em segundo plano na inicialização do serviço e depois no intervalo configurado, ignorando envios que ainda estão sendo gravados. Aplique as alterações reiniciando o serviço com pontia up.

Substituições por variáveis de ambiente

O processo em execução aceita estas substituições:

Variável	Substitui
`PONTIA_HOME`	Diretório de estado e configuração
`PONTIA_EXTERNAL_API_TOKEN`	`external_api_token`
`PONTIA_RUN_MIGRATIONS`	`run_migrations`
`PONTIA_DEFAULT_CLIENT_TYPE`	`default_client_type`
`PONTIA_WORKSPACE_ROOTS`	Raízes de Workspace como entradas `root_id
`PONTIA_DASHBOARD_SOURCE`	`dashboard.source`; um valor vazio desativa o serviço do Dashboard
`PONTIA_PI_TUI_COMMAND`	`runtime.pi.tui_command`; um valor vazio o limpa
`PONTIA_AUTH_ORIGIN`	Origem HTTPS do Pontia Cloud; destinada a implantações controladas e desenvolvimento

Os valores de ambiente têm precedência sobre os valores do arquivo para o processo em execução. Para a configuração persistente do serviço, use o config.toml. O serviço instalado armazena PONTIA_HOME, PONTIA_AUTH_ORIGIN e os caminhos necessários dos Agent Clients separadamente.

Valores booleanos de ambiente aceitam 1, true, yes ou on, e 0, false, no ou off.

Arquivos de estado

O diretório de estado padrão contém dados sensíveis e duráveis:

Caminho	Finalidade
`config.toml`	Configuração persistente do serviço e token da API local
`auth.json`	Credencial da CLI do Pontia Cloud
`e2e-identity.json`	Chave privada da identidade do dispositivo remoto e versão da chave
`data/pontia-e1.db`	Banco de dados local do plano de controle
`workflows/`	Handoffs de Workflows, definições aceitas e documentos de Patch
`state/`	Sockets de runtime, arquivos de inicialização e logs de integração
`cache/dashboard/`	Bundle do Dashboard remoto em cache

Mantenha o diretório de estado privado e proteja os backups dele conforme descrito em Segurança. Use o Gerenciamento de dispositivos para rotacionar ou revogar credenciais remotas.