Fukura
Capture, Search, and Never Forget Your Error Fixes
A Rust CLI for capturing recurring error fixes in a content-addressable store, with fast search (Tantivy), redaction rules, pack files, and a TUI.
Powerful Features
Fukura combines the power of content-addressable storage with lightning-fast search to help you never lose track of error fixes again.
Automatic Error Capture
Daemon automatically captures errors and solutions as you develop, creating a comprehensive knowledge base without manual effort.
- Background daemon monitors your development environment
- Captures error messages and successful solutions
- Auto-generates notes after 5 minutes of inactivity
- Zero-configuration setup with intelligent defaults
- Shell hooks for seamless integration (bash/zsh/fish/powershell)
Lightning-Fast Search
Powered by Tantivy search engine for instant retrieval of relevant error fixes and solutions.
- Sub-second search across thousands of notes
- Full-text search with relevance scoring
- Tag-based filtering and categorization
- Fuzzy matching for typos and variations
- Smart shortcuts: @latest, @1, @2 for quick access
Beautiful TUI Interface
Elegant terminal user interface with multi-pane layout for efficient navigation and editing.
- Multi-pane interface with Tab navigation
- Syntax highlighting for code snippets
- Interactive search with live filtering
- Keyboard shortcuts for power users
- Export to beautiful HTML for browser viewing
Security & Privacy First
Automatic secret redaction and privacy-first design protect your sensitive information.
- Auto-redacts AWS keys, API tokens, passwords, and more
- 14+ security patterns built-in
- All notes private by default
- Local-first storage in `.fukura/`
- No telemetry or data collection
Ready to Get Started?
Join thousands of developers who are already using Fukura to build better software with fewer repeated mistakes.
Quick Start
Get up and running with Fukura in just 3 simple steps. Start capturing and searching your error fixes in minutes.
Initialize Fukura
Initialize Fukura in your project directory. This creates the necessary configuration files and sets up the content-addressable store for your error fixes.
fukura initAdd Your First Note
Add your first error fix note. You can provide the content via stdin, editor, or file. Fukura will automatically capture the solution context.
fuku add --title "Database connection timeout"Search and Find
Search through your collected error fixes using the powerful TUI interface. Use Tab to switch between panes and find exactly what you need.
fuku search "database timeout" --tuiAdvanced Usage
🎯 Automatic Error Capture
Enable automatic daemon mode to capture errors and solutions as you develop.
🖥️ TUI Interface
Use the multi-pane terminal interface for efficient navigation and editing.
Ready for More?
Explore the full documentation to learn about advanced features like pack files, redaction rules, and remote synchronization.
Download Fukura
Get Fukura running on your system in seconds. Choose your preferred installation method.
Recommended Installation
We'll automatically detect your platform and provide the best installation method.
Direct Download
Download portable binaries for your platform
Package Managers
Install via your favorite package manager
From Source
Build from source with Rust toolchain
Docker
Run in containerized environment
Installation Instructions
Debian / Ubuntu
macOS
Windows (PowerShell)
Windows (WSL2/Ubuntu)
Documentation
Complete reference for all Fukura CLI commands and configuration options.
CLI Commands
Configuration
Configuration File
Fukura uses a TOML configuration file located at ~/.config/fuku/config.toml
[daemon]
auto_start = true
watch_paths = ["."]
session_timeout = "5m"
[search]
default_limit = 20
enable_fuzzy = true
[redaction]
patterns = [
"password",
"secret",
"token"
]
[ui]
theme = "dark"
editor = "vim"Environment Variables
FUKURA_CONFIG_PATHCustom path to configuration file
FUKURA_DATA_DIRDirectory for data storage
FUKURA_EDITORDefault editor for note editing