Criei o plugin Vault Terminal para executar Claude Code e Codex na barra lateral direita do Obsidian
(github.com/obst2580)O Obsidian já tem plugins de terminal, mas no meu ambiente Windows eles deixavam a desejar no uso de agent CLIs como Claude Code/Codex em aspectos como funcionamento de PTY, rolagem, cores e tratamento de entradas especiais.
Por isso, criei o plugin Vault Terminal, que abre um terminal real na barra lateral direita do Obsidian e usa o caminho atual do vault como diretório de trabalho.
A ideia foi criar um fluxo em que você mantém no Obsidian notas do projeto, memorandos de arquitetura e logs de trabalho abertos, enquanto no terminal à direita executa diretamente CLIs como claude, codex, git e npm. O Claude Code ou o Codex CLI podem trabalhar com base em AGENTS.md, CLAUDE.md, notas do projeto e arquivos-fonte dentro do mesmo vault.
Os principais recursos são os seguintes.
Executar terminal na barra lateral direita do Obsidian
Executar PowerShell, zsh e bash com base no caminho atual do vault
Executar ferramentas de CLI como Claude Code, Codex CLI, git, npm e Python
Disponibilização de ZIPs de release para Windows/macOS
Suporte padrão a winpty no Windows, com troca para ConPTY quando necessário
Cores de terminal ajustadas aos temas claro/escuro do Obsidian
Tratamento de Shift+Enter para entrada multilinha no Claude Code
Scrollback e rolagem forçada para conferir saídas longas
Suporte à configuração de TLS inspection proxy / CA personalizada do usuário
Ainda está em beta inicial. No momento, em vez do formato de Obsidian Community Plugin, a instalação é feita por vault a partir do ZIP do GitHub Release. É necessário ter o Node.js instalado no sistema, e o Claude Code/Codex CLI também precisa estar disponível para execução como comando de terminal, não como extensão do VS Code.
GitHub:
https://github.com/obst2580/obsidian-powershell
Release:
https://github.com/obst2580/obsidian-powershell/releases
Quero receber feedback de quem usa agent CLIs como Claude Code e Codex CLI junto com o Obsidian em ambientes Windows/macOS.
4 comentários
Eu deixo meu Obsidian Vault em um home server (Ubuntu) e uso o Claude Code via SSH. Com o Synthing, sincronizo só o Vault com outros notebooks ou PCs.
No caso de código também, na maioria das vezes eu deixo tudo no home server e coloco o caminho em arquivos
.mddentro da pasta do Vault.Se você executar o claude code com o comando
-add-dir, também pode conceder permissões automaticamente, então é bem prático.Mas, para usar o terminal na barra lateral... a tela precisa ser grande para ficar realmente confortável..
É verdade que, se a tela for grande, isso acaba sendo bem eficiente.
Mas eu pensei que não seria um grande problema, porque no fim das contas coisas como VS Code ou antigravity também são parecidas, já que você deixa uma janela de chat aberta à direita.
Eu desenvolvo em um ambiente com dois monitores, deixando em um deles vários agentes de diferentes projetos rodando com
cmux, enquanto mantenho os documentos relacionados no caminho do vault do Obsidian de cada projeto.No outro monitor, deixo o Obsidian aberto para ler a documentação e uso a ferramenta claudian ↗ (https://github.com/YishenTu/claudian) para estudar o conteúdo dos documentos ou fazer perguntas sobre ele por meio do chat na aba lateral do Obsidian.
Então, se eu passar a usar a ferramenta que você sugeriu e transformar o projeto em um vault apenas adicionando o arquivo de configuração
.obsidian, parece que vou conseguir usar o Obsidian de uma forma parecida com usar o Cursor ou o Antigravity.Sim, eu também vinha usando o modo CLI com o claudian ou o codexian, mas no fim das contas é mais prático em vários sentidos abrir o terminal original e usar por lá ^^