Amphora

Amphora is a personal knowledge management system (PKMS) built on Obsidian and Neovim. It combines daily notes, script automation and AI integration to capture, organize and retrieve knowledge without friction. Amphora é um sistema pessoal de gestão de conhecimento (PKMS) construído sobre Obsidian e Neovim. Combina daily notes, automações via scripts e integração com IA para capturar, organizar e recuperar conhecimento sem atrito.

The amphora-setup repository publishes the amphora CLI (Rust) and scripts — installable on any Linux system with Obsidian. Configurable via environment variables (AMPHORA_VAULT, AMPHORA_DIR_PERSONAL, AMPHORA_DIR_WORK). O repositório amphora-setup publica a CLI amphora (Rust) e os scripts — instalável em qualquer sistema Linux com Obsidian. Configurável via variáveis de ambiente (AMPHORA_VAULT, AMPHORA_DIR_PERSONAL, AMPHORA_DIR_WORK). 

curl -fsSL https://github.com/nfvelten/amphora-setup/releases/latest/download/amphora-linux-x86_64 -o amphora
chmod +x amphora && ./amphora install

CLI

amphora install Installs components: scripts, git hook, neovim, obsidian, claude Instala componentes: scripts, hook git, neovim, obsidian, claude
amphora check Checks dependencies and installation state Verifica dependências e estado da instalação
amphora update Updates scripts and configurations to the latest version Atualiza scripts e configurações para a versão mais recente
amphora guide Opens interactive usage guide: scripts, hooks, neovim, obsidian Abre guia interativo de uso: scripts, hooks, neovim, obsidian
amphora uninstall Removes installed components Remove componentes instalados

Scripts

meeting-record

Records microphone audio and transcribes with Whisper when stopped. Automatically saves to Work/Meetings/ with date and Claude-generated summary. Grava áudio do microfone e transcreve com Whisper ao parar. Salva automaticamente em Work/Meetings/ com data e resumo gerado pelo Claude.

video-note

Downloads subtitles from a YouTube video, summarizes with Claude and saves to Personal/Videos/ as an Obsidian note. Baixa legendas de um vídeo do YouTube, resume com Claude e salva em Personal/Videos/ como nota Obsidian.

newsboat-save

Scrapes and summarizes an article from Newsboat. Saves to Personal/Reading/ as a note with title, source and summarized content. Scrape + resumo de artigo a partir do Newsboat. Salva em Personal/Reading/ como nota com título, fonte e conteúdo resumido.

vault-log-updates

Logs pacman package updates in Personal/System/Updates.md. Configurable via environment variables. Loga atualizações de pacotes pacman em Personal/System/Updates.md. Configurável via variáveis de ambiente.

Integrations Integrações

Obsidian

Templates for daily note, weekly review, technical note and work task. Plugin configuration (obsidian-git, dataview, templater, tasks) ready to use. Templates para daily note, weekly review, nota técnica e demanda de trabalho. Configuração de plugins (obsidian-git, dataview, templater, tasks) pronta para uso. 

amphora install obsidian

Neovim

Vault plugin for Neovim with task picker, quick capture and note navigation via obsidian.nvim. Keymaps at v and o. Plugin de vault para Neovim com task picker, quick capture e navegação entre notas via obsidian.nvim. Keymaps em v e o. 

amphora install nvim

Git hook (post-commit)

Hook that automatically logs commits to the daily note when pushing in any repository. Hook que loga commits automaticamente na daily note ao fazer push em qualquer repositório. 

amphora install hook