Gosidian

gosidian

Notas Markdown que seus agentes de IA podem ler, escrever e raciocinar — via MCP.

Um cofre Markdown autocontido com um servidor MCP integrado. Humanos editam através de uma interface web, agentes conversam com ele via MCP, tudo vive em arquivos .md simples que o Obsidian (e qualquer outra ferramenta Markdown) lê nativamente.

Experimente no seu navegador

Inicie um gosidian gratuito e descartável no GitHub Codespaces — sem instalação, rodando na sua própria cota do Codespaces. Ele compila a partir do código-fonte, cria um cofre de demonstração pequeno e abre a interface web. Entre com demo / gosidian-demo.

Início rápido

docker run -d --name gosidian \
  -p 8080:8080 \
  -v "$(pwd)/vault:/vault" \
  ghcr.io/daniele-chiappa/gosidian:latest
# open http://localhost:8080, create admin, copy the MCP token from /admin/tokens
claude mcp add gosidian http://localhost:8080/mcp \
  --transport http --header "Authorization: Bearer $TOKEN"

Três comandos: Docker up → token criado pela interface web → agente conectado. Seu cofre .md é persistido em ./vault/; pare o contêiner e os arquivos ainda estarão lá.

Outros caminhos de instalação (código-fonte, compose personalizado, bare-metal): docs/getting-started.md.

O que é o gosidian

• Um cofre Markdown. As notas são arquivos .md no disco. Abra a mesma pasta no Obsidian, VS Code, vim ou qualquer editor que você já usa. Zero dependência: exclua .gosidian/ e você terá um cofre Obsidian puro.
• Um servidor MCP. 57 ferramentas tipadas permitem que agentes iniciem uma sessão, ingiram arquivos, pesquisem, leiam, escrevam, vinculem, façam handoff, auto-verifiquem e auditem. Autenticação por token Bearer com escopo por projeto.
• Uma interface web. Um aplicativo de página única Vue 3 servido pelo mesmo binário (compilado com Vite, embutido via go:embed). Notas, grafo, pesquisa e formulários de configuração abrem como janelas em um espaço de trabalho "plancia" em mosaico — pesquisa de texto completo, backlinks, visualização de grafo, editor com pré-visualização ao vivo, trilha de auditoria e páginas administrativas para tokens e usuários.

As três visões acessam os mesmos arquivos no disco. O índice SQLite FTS5 é um cache — remova-o e ele será reconstruído.

Para quem é

• Engenheiros de IA conectando agentes que precisam de memória estruturada persistente: anotações, planos, habilidades, ADRs, handoffs, auditoria.
• Usuários do Obsidian que querem uma camada programável sobre um cofre em que já confiam.
• Equipes com cofre compartilhado + tokens com escopo por projeto para cada agente.

Por que gosidian em vez de X

• vs RAG / busca vetorial: gosidian recupera por identidade (caminho, tag, frontmatter, backlinks) — mais previsível do que busca por similaridade para a memória de trabalho de um agente. Busca semântica é deliberadamente adiada: veja justificativa do ADR-007.
• vs Obsidian Sync: Sync espelha um cofre entre dispositivos humanos. gosidian adiciona uma superfície de automação tipada (MCP) ao mesmo cofre. Não é concorrente — é complementar.
• vs Notion / Roam: formatos hospedados ou proprietários; migração é um projeto. O cofre do gosidian já é arquivos .md que você pode levar para qualquer lugar.

O FAQ cobre a versão longa.

Destaques de recursos

• Binário único, ≤50 MB, imagem Docker baseada em Alpine
• Interface web: um SPA Vue 3 (Vite, Pinia, Tailwind, CodeMirror, Cytoscape), embutido no binário — editor + pré-visualização ao vivo, barra lateral, pesquisa, visualização de grafo, anexos, log de auditoria, páginas administrativas
• Plancia gerenciador de janelas em mosaico (estilo niri): notas, grafo, pesquisa e formulários de configuração abrem como janelas redimensionáveis, lado a lado, em um espaço de trabalho com rolagem horizontal, restauráveis pela URL
• Servidor MCP sobre Streamable HTTP (HTTP+SSE legado mantido) com 57 ferramentas tipadas
• Tokens Bearer com escopos (read / write) e restrição por projeto — incluindo tokens multi-projeto para orquestradores; revogação em cascata ao desabilitar usuário
• Barramento de orquestração de agentes: notas de handoff com ciclo de vida atômico de claim/complete, identidade carimbada pelo servidor e um feed de mudanças long-poll memory_wait_changes — uma fila de tarefas multi-agente mínima onde tudo permanece em Markdown simples
• Login web multiusuário com controle de acesso baseado em funções (owner / member / guest), visibilidade pública/privada por projeto e cadastro somente por convite (TTL de 24h)
• Autenticação de dois fatores TOTP opcional (modo global + override por usuário) e login LDAP / Active Directory com provisionamento automático de convidados
• Sincronização git opcional (commits com debounce, push com autenticação por token)
• Pesquisa de texto completo SQLite FTS5 + bloqueio otimista com ETag
• Notas .html de primeira classe, renderizadas em iframe com sandbox (desativado por padrão, opt-in por projeto)
• Análise de grafo sobre o grafo de wikilinks: memory_hubs (notas mais vinculadas) e memory_path (caminho mais curto entre duas notas)
• Loop de auto-melhoria opt-in: agentes registram insights de atrito de uso por token, desativado por padrão
• Imprimir / Salvar como PDF para qualquer nota Markdown direto da interface web
• Internacionalização (IT + EN completos; ES / FR / DE em estruturação)
• Predefinições de tema claro e escuro (Catppuccin, Tokyo Night, Solarized) + paleta personalizada
• Layout de projeto opinativo Karpathy-Wiki-Stack com scaffolding em uma chamada
• Projetos globais opcionais para habilidades, agentes e modelos de scaffolding compartilhados entre projetos (opt-in por projeto, local sobrescreve global)

Documentação

Área	Comece aqui
Instalar + configurar	Começando, Configuração, Implantação
Integração MCP	Visão geral, Catálogo de ferramentas, Autenticação, Configuração do cliente, Padrões de agente
Interface web	Visão geral, Editor, Autenticação e funções, Configurações
Cofre	Formato, Convenções, Multi-projeto, Projetos globais, Compatibilidade com Obsidian
Internos	Arquitetura, Desenvolvimento
Perguntas comuns	FAQ

Índice completo: docs/README.md.

Contribuindo

Contribuições são bem-vindas. Veja CONTRIBUTING.md para o fluxo de trabalho, expectativas de teste e diretrizes de tradução.

Segurança

Problemas de segurança são relatados de forma privada. Veja SECURITY.md para o processo de divulgação.

Licença

Lançado sob a Licença MIT.

Veja também

• PROJECT-STORY.md — gênese do projeto, filosofia de design e uma comparação com Obsidian / Logseq / pilhas de conhecimento baseadas em RAG.
• CHANGELOG.md — histórico de versões.
• Filosofia de design e gênese do projeto.