You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Recaller searches your files and shell history locally with smart ranking, instant help lookup, and terminal integration. All processing happens on your machine - your command history never leaves your computer.
curl -sf https://raw.githubusercontent.com/cybrota/recaller/refs/heads/main/install.sh | sh
25
+
```
12
26
13
-
## ✨ Features
27
+
Key Features of Recaller:
14
28
15
-
### 🔍 Command History Search
16
-
-**Smart Search**: Commands ranked by frequency and recency with configurable search modes
17
-
-**Fuzzy Search**: Substring matching anywhere in commands (default)
18
-
-**Prefix Search**: Fast matching of command beginnings (configurable)
19
-
-**Instant Help**: View man pages and command documentation without leaving the interface
20
-
-**Terminal Integration**: Copy to clipboard or execute in new terminal tabs
29
+
***Smart Command Search**: Commands ranked by frequency and recency with configurable search modes.
30
+
***Instant Help**: View man pages and command documentation without leaving the interface.
31
+
***Terminal Integration**: Copy to clipboard or execute in new terminal tabs.
32
+
***Multi-Directory Indexing**: Index multiple directories simultaneously for comprehensive file search.
33
+
***Auto Re-indexing**: Automatically discovers new files when launching the search UI.
34
+
***Smart File Ranking**: Files ranked by access frequency and recency.
35
+
***Privacy First**: All processing happens locally - your history stays on your machine.
21
36
22
-
### 📁 Filesystem Search
23
-
-**Multi-Directory Indexing**: Index multiple directories simultaneously for comprehensive file search
24
-
-**Auto Re-indexing**: Automatically discovers new files when launching the search UI
25
-
-**Smart File Ranking**: Files ranked by access frequency and recency
26
-
-**Filter Toggle**: Instantly switch between showing all files, directories only, or files only
27
-
-**Fast Search**: Blazing-fast search through indexed files and directories
28
-
-**File Operations**: Open files with default applications or copy paths to clipboard
37
+
## Why use Recaller?
29
38
30
-
### 🔒 Privacy & Performance
31
-
-**Privacy First**: All processing happens locally - your history stays on your machine
32
-
-**Keyboard-Driven**: Full keyboard navigation with intuitive shortcuts
33
-
-**Cross-Platform**: Works on macOS and Linux with automatic terminal detection
39
+
Tired of forgetting complex commands or searching for files across different directories? Recaller is here to help. It provides a fast, private, and efficient way to search your command history and files. With its smart ranking and instant help features, you can boost your productivity and streamline your workflow. And since all processing happens locally, your data remains private and secure.
recaller fs clean --dry-run # Preview what would be cleaned
110
118
```
111
119
112
-
> **🔄 Auto Re-indexing**: When you launch `recaller fs`, it automatically re-indexes all previously indexed directories to discover new files and folders that were added since the last indexing. This keeps your search results up-to-date without manual intervention.
113
-
114
120
### Configuration
115
121
```bash
116
122
recaller settings list # View current configuration settings
117
123
recaller version # Check version
118
124
```
119
125
120
-
## 🔍 Search Modes
121
-
122
-
**Fuzzy Search** (Default)
123
-
- Matches commands containing your search query **anywhere**
124
-
- More intuitive and finds commands with keywords in any position
**Your data stays local**: Recaller processes your command history entirely on your machine. No data is sent to external servers or cloud services. Your command history remains private and secure.
156
-
157
-
## 📋 Requirements
158
-
159
-
-**OS**: macOS 10.12+ or Linux
160
-
-**Clipboard**: Linux users need `xclip` (`sudo apt install xclip`)
161
-
-**Terminals**: Auto-detects Terminal.app, iTerm2, GNOME Terminal, Konsole, and others
162
-
163
-
164
-
## 🔄 Shell Support
165
-
166
-
| Shell | Support | Setup |
167
-
|-------|---------|-------|
168
-
|**Bash**| ✅ Full |[Required config](docs/setup-bash.md)|
169
-
|**Zsh**| ✅ Full |[Optional config](docs/setup-zsh.md)|
170
-
|**Fish**| 🔄 Planned | - |
171
-
172
-
> **⚠️ Bash users**: Requires timestamped history. See [setup guide](docs/setup-bash.md).
173
-
174
126
## 🤝 Contributing
175
127
176
128
Contributions welcome! Areas for improvement:
@@ -186,32 +138,6 @@ cd recaller && go mod tidy && go run .
186
138
187
139
## 📝 License
188
140
189
-
Licensed under the Apache License, Version 2.0 (the "License");
190
-
you may not use this file except in compliance with the License.
191
-
You may obtain a copy of the License at
192
-
193
-
http://www.apache.org/licenses/LICENSE-2.0
194
-
195
-
Unless required by applicable law or agreed to in writing, software
196
-
distributed under the License is distributed on an "AS IS" BASIS,
197
-
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
198
-
See the License for the specific language governing permissions and
0 commit comments