winget install --id=shizgnit.tachikoma -e Tachikoma is a terminal-based filesystem reconnaissance tool that renders an interactive, size-aware directory tree. It highlights space hogs at a glance with per-directory totals, color-coded sizes, and fast recursive scanning of large trees.
> "Memories, I can't believe they can delete that!"
A cross-platform TUI (Text User Interface) filesystem reconnaissance tool inspired by Ghost in the Shell. Interactively browse your filesystem with size totals, color-coded entries, and vim-style navigation.
/help, /quit, /scan, /path, /status) with tab completionbrew install shizgnit/tap/tachikoma
(The formula builds from source against the latest tagged release.)
winget install shizgnit.tachikoma
(Subject to review/approval in microsoft/winget-pkgs. Until it lands, use a GitHub Release zip below.)
Download the latest release asset for your OS from , unzip (Windows), and run tachikoma in any terminal. The Windows build is a single self-contained exe with no runtime dependencies.
# Clone the repository
git clone https://github.com/shizgnit/tachikoma.git
cd tachikoma
# Bootstrap vcpkg (macOS/Linux)
./vcpkg/bootstrap-vcpkg.sh -disableMetrics
# Windows: .\vcpkg\bootstrap-vcpkg.bat -disableMetrics
# Configure and build (macOS/Linux)
cmake -B build -DCMAKE_TOOLCHAIN_FILE=./vcpkg/scripts/buildsystems/vcpkg.cmake
cmake --build build --config Release
# Windows: use the static triplet so the exe is fully self-contained
# (no pdcurses.dll or VC++ runtime required at runtime)
cmake -B build -DCMAKE_TOOLCHAIN_FILE=vcpkg/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows-static
cmake --build build --config Release
# Run
./build/tachikoma /path/to/scan
cd build
ctest --output-on-failure
# Scan current directory
./build/tachikoma
# Scan specific path
./build/tachikoma /Users
# Scan home directory
./build/tachikoma ~
| Key | Action |
|---|---|
j / ↓ | Move down |
k / ↑ | Move up |
l / → / Enter | Expand directory (lazy-loads children) |
h / ← | Collapse directory |
F5 | Refresh filesystem scan |
q | Quit |
Press / to open the command bar, then type a command and press Enter:
| Command | Description |
|---|---|
/help | Show available commands (overlay) |
/quit | Exit the application |
/scan | Refresh filesystem scan with progress |
/path | Show current scan path |
/status | Show system status |
Tab completion: Press Tab to cycle through matching command suggestions. Press ESC to cancel.
tachikoma/
├── src/
│ ├── app/ # Main application entry point
│ │ └── main.cpp
│ ├── ui/ # TUI library
│ │ ├── terminal.cpp # Terminal RAII manager (init/shutdown)
│ │ ├── renderer.cpp # Text rendering (color, attributes, boxes)
│ │ ├── input.cpp # Keyboard input handling
│ │ ├── tree_view.cpp # Interactive tree view component
│ │ ├── logo.cpp # Startup screen with ASCII art
│ │ ├── command_bar.cpp # Slash command input bar
│ │ └── status_bar.cpp # Progress/status display
│ └── filesystem/ # Filesystem scanning library
│ ├── scanner.cpp # Recursive directory scanner with lazy loading
│ └── entry.cpp # Filesystem entry struct and utilities
├── include/
│ ├── ui/ # TUI headers
│ └── filesystem/ # Filesystem headers
├── tests/
│ ├── test_filesystem.cpp # Scanner and entry tests (17 tests)
│ └── test_utils.cpp # Size formatting and utility tests (20 tests)
├── CMakeLists.txt # Build configuration
└── vcpkg.json # vcpkg manifest (ncurses dependency)
TerminalGuardMIT