Fornece uma camada de memória e continuidade local-first que permite que diferentes agentes de codificação de IA compartilhem contexto e retomem o trabalho de onde outro parou.
Também conhecido como Coder8124/logos, @noeton/logos
- Stars
- 4
- Ferramentas
- —
- Downloads, 30 dias
- —
- Versão mais recente
- —
- Último commit
- 9 de nov. de 2026
- Licença
- Apache-2.0
O que é o MCP Logos?
Logos é um MCP server. Fornece uma camada de memória e continuidade local-first que permite que diferentes agentes de codificação de IA compartilhem contexto e retomem o trabalho de onde outro parou.
Resumo gerado a partir do README do projeto
Sobre o MCP server de Logos
Desenvolvedores que utilizam múltiplos agentes de codificação de IA podem usar o logos para manter a continuidade entre diferentes sessões e ferramentas. Ele atua como uma camada de memória local-first onde agentes como Claude Code, Cursor e Codex compartilham um único vault de arquivos markdown. Essa configuração permite que um agente salve um checkpoint de seu progresso para que um modelo ou ferramenta diferente possa retomar o trabalho exatamente onde o anterior parou.
O sistema opera inteiramente na sua máquina, garantindo a privacidade dos dados ao manter o vault local. Ele utiliza um índice SQLite para cache, que pode ser reconstruído usando o comando logos index sem perda de dados. Os usuários podem instalá-lo via Homebrew no macOS e Linux ou através do npm no Windows. O servidor suporta vários hosts, incluindo Claude Desktop, Cline, Devin e GitHub Copilot, fornecendo um CLI para agentes que possuem apenas acesso ao shell.
Além da simples retomada de tarefas, o servidor ajuda a evitar que os agentes repitam abordagens que falharam por meio da ferramenta before_you_try. Ele também permite que desenvolvedores consultem o raciocínio por trás de mudanças específicas no código usando o comando why. Você pode importar o histórico existente de projetos de fontes como o histórico do git, regras do Cursor ou CLAUDE.md para popular o vault de memória.
O que você pode fazer com ele
- 1Retomar tarefas de codificação interrompidasPasse um projeto de um agente de IA para outro recuperando o último estado conhecido e as tarefas em aberto.
- 2Evitar erros de codificação repetitivosImpeça que um novo agente tente uma solução que já se provou malsucedida.
- 3Compreender decisões históricas de códigoPeça à IA para explicar a lógica por trás da implementação atual de um arquivo específico.
- 4Migrar memórias de agentes existentesMova seu vault de memória anterior para o novo sistema logos.
Escrito a partir do README do projeto. Cada caso de uso é verificado com uma citação dele.
Como instalar o MCP Logos
Formatos verificados em 10 nov 2026Adicionar ao CursorAdicionar ao GooseInstalar o MCP Logos no Claude Code
$ claude mcp add logos -- npx -y @noeton/logosInstalar o MCP Logos no Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"logos": {
"command": "npx",
"args": [
"-y",
"@noeton/logos"
]
}
}
}Instalar o MCP Logos no VS Code
.vscode/mcp.json
{
"servers": {
"logos": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noeton/logos"
]
}
}
}Instalar o MCP Logos no VS Code CLI
$ code --add-mcp '{"name":"logos","type":"stdio","command":"npx","args":["-y","@noeton/logos"]}'Instalar o MCP Logos no Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"logos": {
"command": "npx",
"args": [
"-y",
"@noeton/logos"
]
}
}
}Instalar o MCP Logos no Codex
$ codex mcp add logos -- npx -y @noeton/logosInstalar o MCP Logos no Codex config.toml
~/.codex/config.toml
[mcp_servers.logos] command = "npx" args = ["-y", "@noeton/logos"]
Instalar o MCP Logos no Gemini CLI
$ gemini mcp add -s user logos npx -- -y @noeton/logosInstalar o MCP Logos no Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"logos": {
"command": "npx",
"args": [
"-y",
"@noeton/logos"
]
}
}
}Verificações automatizadas
Executado em 14 de nov. de 2026Relatório completo →Passou em nossas verificações automatizadas. Isso não é uma auditoria de segurança: leia o código e dê ao servidor o acesso mais restrito de que ele precisa. Como as verificações funcionam
- Repositório de origem vinculado e acessívelcoder8124/logos is public and reachablegithub.com/coder8124/logos ↗Passou
- O pacote indica este repositório como sua origem@noeton/logos names coder8124/logos as sourcenpmjs.com/package/@noeton/logos ↗Passou
- Proveniência da build (atestação Sigstore)Sigstore attestation for @noeton/logosnpmjs.com/package/@noeton/logos/v/0.5.8#provenance ↗Passou
- Licença de código aberto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Passou
- Commit ou release no último anoLast commit or release 2026-11-09github.com/coder8124/logos ↗Passou
- OpenSSF ScorecardNão verificado
- Nome do pacote não é próximo a um pacote popularNo popular package one edit away from @noeton/logosPassou
- Nenhum aviso crítico no pacote ou em suas dependênciasNão verificado
- Sem instruções ocultas para o modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPassou
- Ferramentas destrutivas estão rotuladasNão verificado
- O endpoint remoto responde ao handshake do MCPNão verificado
README
Ver no GitHubLogos
When one coding agent stops, the next one continues the work.
Docs · Quick Start · Benchmark · Site · Issues
Logos is a local-first memory and continuity layer for coding agents. Claude Code, Codex, Cursor and your own agents share one vault over MCP. An agent checkpoints what it did, and the next one resumes where it stopped, even if it is a different model, in a different tool, on a different day.
Claude Code ──▶ checkpoint ──▶ Logos ──▶ resume ──▶ Cursor
(your vault)
The vault is a folder of markdown files on your machine. Nothing is uploaded,
and the SQLite index beside it is a cache: delete it, run logos index, and you
lose nothing.
Quick start
brew install coder8124/tap/logos-mcp && logos setup # macOS and Linux
npm i -g @noeton/logos && logos setup # Windows
setup picks a vault, shows which agents it would wire, and asks before
touching any of them (--dry-run writes nothing). For Claude Code it also
installs the plugin, so the last handoff is in front of the model before it does
anything.
The formula is logos-mcp: a bare brew install logos installs Logos Bible
Software. Building from source, hand-wiring a host and the one-click buttons are
in Installation.
What it does
- Resume where the last agent stopped.
resumeshows what was done, what was verified and what is still open. - Stop the next agent repeating a dead end. Ruled-out approaches are their
own field, and
before_you_trychecks a plan against them. - Keep "verified" apart from "claimed". Resume marks another agent's verified items as its claim, and flags a command the activity log never saw.
- Answer "why is this code like this?"
why <path>shows what was being decided when a file was last worked on. - Remember what lasts. Decisions, constraints and procedures, reviewed before they become project memory.
- Bring your history. Import CLAUDE.md, AGENTS.md, Cursor rules, claude-mem, Claude Code's auto memory, transcripts or git history.
Every write returns a receipt, so you can see it working. The Handoff Loop shows how an agent uses it, step by step.
Works with
Claude Code, Codex, Cursor, Claude Desktop, Cline, Devin, GitHub Copilot, opencode, Amp, Grok Build, and anything else that speaks MCP. Agents with only a shell get a CLI command for every tool. See Agent Hosts.
Does it work?
On a handoff suite built for this (32 scenarios, nine memory systems, one machine), Logos passes 84.4%. The next best system passes 46.9%.
Every real system retrieves about equally well. What separates them is whether the agent that resumes gets the current answer, or gets it next to the stale one it replaced. Method, per-scenario scores and the cases Logos loses are in the benchmark.
Local, private and durable
- No model required. Search falls back from local embeddings (Ollama) to full-text search, and nothing breaks.
- Nothing is observed. Logos does not watch your screen, browser or files. The vault holds what agents wrote there, plus the Claude Code plugin's activity log, which you can turn off.
- Nothing leaves.
logos doctor --egresslists every address Logos can contact, and when. - Hard to break. It survives SIGKILL mid-write, a full disk, sync-client
conflict copies and two worktrees racing on one vault (
chaos/).
Exactly what is recorded, and every switch for it, is in Settings and Privacy.
Documentation
Everything lives in the wiki.
| Start | Use | Look up |
|---|---|---|
| Installation | The Handoff Loop | CLI Reference |
| Quick Start | Memory | MCP Tools Reference |
| Core Concepts | Importing History | Agent Hosts |
| Troubleshooting | The Vault | Embedding in Go |
Contributing
Contributions are welcome. CONTRIBUTING.md covers the build,
the test tiers and the two load-bearing conventions: the vault is the truth, and
every feature announces itself. Agents working here get the context-connect
and continuity skills from the plugin (plugin/skills/); this repository
dogfoods its own plugin.
Coming from brain? Since 0.5.0 the old names are not read. logos migrate
moves a ~/brain vault; see
Moving a 0.4 vault.
License
Apache 2.0. See LICENSE. Git history satisfies §4(b), so there are no change notices to add and no CLA (details). Prior work that shaped the ideas is in systemmd/CREDITS.md.
Perguntas sobre o MCP Logos
Como adiciono o MCP Logos ao Claude Code?
Execute claude mcp add logos -- npx -y @noeton/logos no seu terminal. Adicione --scope user para torná-lo disponível em todos os projetos.
Como adiciono o MCP Logos ao Cursor?
Abra ~/.cursor/mcp.json e adicione o servidor em mcpServers, usando a configuração do Cursor mostrada na seção de instalação acima.
Como o Logos lida com a privacidade dos dados?
O Logos é local-first; o vault é uma pasta de arquivos markdown na sua máquina e nada é enviado para a nuvem.
Posso usar o Logos com diferentes agentes de IA?
Sim, ele funciona com Claude Code, Codex, Cursor, Claude Desktop, Cline, Devin, GitHub Copilot e qualquer outra ferramenta que suporte MCP.
O que acontece se eu deletar o arquivo de índice?
Você não perderá nada; basta executar o comando index para reconstruí-lo.
É necessário um LLM para funcionar?
Nenhum modelo é necessário para as funcionalidades básicas; a busca utiliza busca de texto completo caso os embeddings locais não estejam disponíveis.