Documentação do Geneziz

Visão geral

O Geneziz é uma base de conhecimento local-first que transforma saves espalhados em um segundo cérebro estruturado e pesquisável. Ele captura saves do X.com (bookmarks), GitHub, YouTube, Reddit, Instagram, TikTok, Cosmos, Hacker News e RSS - além de páginas salvas do navegador - enriquece cada item com IA e armazena tudo como arquivos Markdown puros na sua máquina.

Cada item arquivado recebe uma categoria, tags, uma descrição de uma linha e uma nota de prioridade, e então vai para o app desktop (ou visualizador web), onde você pode navegar, filtrar e pesquisar. Um MCP server integrado expõe sua base de conhecimento a assistentes de IA como Claude Code, Cursor e Windsurf, para que suas sessões de código possam consultar o que você salvou.

Seus dados nunca saem da sua máquina. Os arquivos podem ser consultados com grep, versionados com git e lidos em qualquer editor de texto.

Instalação

Baixe o build desktop mais recente para a sua plataforma. Não é necessário Python nem Node.js - o app vem como um instalador nativo autossuficiente.

Depois de executar o instalador, abra o Geneziz e o assistente de configuração inicial aparece automaticamente.

Configuração inicial

O assistente de configuração coleta quatro informações. Você pode pular qualquer uma delas e voltar mais tarde em Settings.

License key

Digite sua licença no formato GNZ-XXXX ou GNZD-XXXX. Uma licença custa US$ 99, preço único e é ativada em até 3 dispositivos.

X.com

Instale a extensão de navegador Save to Geneziz (incluída no app desktop do Geneziz). Ela captura dentro da sua própria sessão logada do X.com enquanto você navega - o Geneziz nunca lê os cookies armazenados do seu navegador e nada é enviado para a nuvem. Fontes com APIs oficiais (GitHub) conectam com seu próprio token/OAuth.

AI provider

Escolha como o Geneziz enriquece os itens. Quatro modos são suportados:

• Proxy de IA do Geneziz (hospedado) - usa a API do Geneziz, consome seus créditos inclusos, sem chave
• Anthropic - use a sua própria chave da Anthropic
• OpenAI-compatible - OpenAI, OpenRouter, GLM ou qualquer endpoint compatível
• Ollama - totalmente local

Levar a sua própria chave significa processamento ilimitado, sem consumo de créditos.

GitHub token

Opcional. Cole um personal access token para sincronizar suas estrelas do GitHub. Sem ele, a etapa do GitHub é ignorada.

Importando seus dados

Bookmarks do X.com

A captura do X.com é somente de bookmarks, e acontece pela extensão de navegador na sua sessão logada (veja Configuração inicial). O fetch pela CLI percorre suas fontes e contas conectadas:

geneziz fetch --source github          # todas as contas GitHub ativas
geneziz fetch --source github --account gh-work   # apenas uma

Estrelas do GitHub

Sincronize seus repositórios com estrela. Cada repositório é categorizado e arquivado como um arquivo Markdown de conhecimento.

geneziz sync

Pocket

Importe um export JSON do Pocket. Exporte sua biblioteca pela interface web do Pocket e então:

geneziz import-pocket --input path/to/pocket-export.json

Referência da CLI

O Geneziz vem com uma CLI completa. Execute geneziz --help para a lista atualizada e as flags.

O pipeline de um comando executa o ciclo completo de ponta a ponta:

geneziz run             # fetch → process (IA) → index
geneziz run --no-ai     # somente arquivamento determinístico, sem IA

Provedores de IA

O Geneziz suporta quatro modos de IA para enriquecimento:

Use a sua própria chave (BYOK) para processamento ilimitado, sem consumo de créditos. Com o proxy padrão, o uso de créditos varia por operação e sai do seu saldo incluso, e você sempre vê o preço exato antes de qualquer execução.

Licenciamento e créditos

O Geneziz custa US$ 99 uma vez - sem assinatura, nunca.

• License (US$ 99 preço único): app desktop + CLI + MCP server + semantic search, 100 créditos de IA bônus para começar, até 3 dispositivos
• Pacotes de créditos avulsos: US$ 12.99 (100) · US$ 24.99 (250) · US$ 44.99 (500) · US$ 79.99 (1.000)
• Pule os créditos completamente usando a chave do seu próprio provedor de IA

Veja /landing#pricing para os preços atuais.

Pesquisa

O Geneziz permite pesquisar sua base de conhecimento de duas formas - ambas executam localmente e offline.

• Full-text search - correspondência rápida de palavras-chave com ranking
• Semantic search - encontra itens por significado, não apenas palavras exatas

geneziz search "react performance"            # palavra-chave
geneziz search "rust async runtime" --semantic # por significado

Seus dados

Tudo é armazenado como Markdown com YAML frontmatter, diretamente na sua máquina. São arquivos puros seus - abra-os em qualquer editor, pesquise com grep ou versione no git.

Para o formato exato dos arquivos e um exemplo de arquivo de tool, veja o vault (em inglês).

MCP server

O Model Context Protocol (MCP) server expõe sua base de conhecimento a qualquer assistente de IA compatível com MCP. Ele lê seus arquivos locais diretamente - nada sai da sua máquina.

As tools mais usadas:

O guia completo - qual tool usar, em que ordem - está em Como tirar o máximo do servidor MCP do Geneziz (em inglês).

Configuração

O caminho de um comando só: geneziz mcp register escreve a entrada do servidor em todos os clientes de IA detectados na sua máquina - Claude Desktop, Claude Code, Cursor, Windsurf, Codex, VS Code, ZCode e OpenCode:

geneziz mcp register

Cada cliente recebe uma entrada geneziz com o caminho absoluto do executável do Geneziz, o argumento mcp e uma variável de ambiente GENEZIZ_DATA_DIR apontando para o diretório dos seus dados - então nenhuma configuração de PATH é necessária. O registro atualiza apenas a entrada do próprio Geneziz (as demais definições de servidor no mesmo arquivo ficam intocadas, e um backup único é criado antes da primeira alteração) e é fácil de desfazer:

geneziz mcp register --status        # estado do registro por cliente (JSON)
geneziz mcp register --remove --all  # remove apenas as entradas do Geneziz

O app desktop executa o mesmo registro automaticamente na instalação e no primeiro uso - ativado por padrão, com opção de desativar nas configurações.

Prefere configurar manualmente? Registre o servidor no seu assistente de IA como um MCP server stdio usando o comando geneziz mcp. Para o Claude Code, adicione em ~/.claude/settings.json:

{
  "mcpServers": {
    "geneziz": {
      "command": "geneziz",
      "args": ["mcp"],
      "type": "stdio"
    }
  }
}

Cursor e Windsurf aceitam a mesma definição de servidor pelas suas interfaces de configuração de MCP.

Em uma nova sessão, faça uma pergunta que envolva o que você salvou:

Quais tools eu salvei para Rust async?

O assistente pesquisa sua base de conhecimento local e responde com títulos, categorias e trechos. Veja Setting up the Geneziz MCP server with Claude Code para o passo a passo completo.

FAQ

Meus dados são realmente locais? Sim. Tudo fica como Markdown puro na sua máquina, funciona offline, é pesquisável com grep e pode ser versionado no git.

Existem assinaturas? Não. O Geneziz é uma compra única de US$ 99.

É open source? O Geneziz é um software proprietário; o formato dos dados é 100% aberto - Markdown puro com YAML.

Funciona no Mac e no Windows? Sim. O Geneziz é um app desktop nativo para macOS e Windows.

E se vocês encerrarem o produto? Seus arquivos continuam sendo seus. Não há dependência de nuvem - cada arquivo permanece legível em qualquer editor, com ou sem o Geneziz em execução.

Suporte

Dúvidas, bugs ou feedback: support@geneziz.app. Veja /landing para detalhes e preços do produto.