@dev_desh/flux-cap 0.7.0 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +81 -17
- package/dist/index.js +44785 -4139
- package/package.json +62 -50
package/README.md
CHANGED
|
@@ -2,10 +2,16 @@
|
|
|
2
2
|
|
|
3
3
|
**A git-aware CLI context manager for ADHD developers**
|
|
4
4
|
|
|
5
|
-
> *Never lose track of what you were coding after interruptions again.*
|
|
5
|
+
> *Never lose track of what you were coding after interruptions again. Now with intelligent, context-aware search.*
|
|
6
|
+
|
|
6
7
|
|
|
7
8
|
flux-cap is a terminal-native tool that captures your thoughts, tracks your context, and integrates seamlessly with your git workflow. Built specifically for developers who context-switch frequently.
|
|
8
9
|
|
|
10
|
+
### Recent Releases:
|
|
11
|
+
- **v0.8.0:** Search 2.0 - Intelligent multi-signal ranking with context awareness
|
|
12
|
+
- **v0.7.0:** Batch searches with combinedQuery and result sorting
|
|
13
|
+
|
|
14
|
+
|
|
9
15
|
## Installation
|
|
10
16
|
|
|
11
17
|
Install flux-cap globally using your preferred package manager:
|
|
@@ -40,21 +46,68 @@ flux dump -i "add dark mode toggle" # Ideas
|
|
|
40
46
|
flux dump -n "team meeting at 3pm tomorrow" # Notes
|
|
41
47
|
flux dump -t "refactor payment processing logic" # Tasks
|
|
42
48
|
```
|
|
49
|
+
## 3. **New TUI Section** (add after Commands)
|
|
43
50
|
|
|
44
|
-
|
|
51
|
+
## Interactive TUI
|
|
45
52
|
|
|
46
|
-
|
|
53
|
+
Flux-Cap includes a terminal user interface for interactive searching:
|
|
47
54
|
|
|
55
|
+
|
|
56
|
+
|
|
57
|
+
### Features
|
|
58
|
+
- **Real-time Search**: Results update as you type
|
|
59
|
+
- **SearchV2 Integration**: Same scoring system as CLI search
|
|
60
|
+
- **Professional Layout**: Fixed table format matching CLI output
|
|
61
|
+
- **Context Tags**: Visual indicators for recent, same-branch, same-dir
|
|
62
|
+
- **Stable Interface**: Fixed height prevents layout jumps
|
|
63
|
+
- **Slash Commands**: Type `/exit` to quit cleanly
|
|
64
|
+
|
|
65
|
+
### Usage
|
|
48
66
|
```bash
|
|
49
|
-
#
|
|
50
|
-
flux
|
|
67
|
+
# Start interactive search
|
|
68
|
+
flux u
|
|
69
|
+
|
|
70
|
+
# Search and navigate
|
|
71
|
+
# Type query -> See results instantly
|
|
72
|
+
# /exit -> Quit cleanly
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
### 3. Search your brain dumps with intelligent ranking
|
|
76
|
+
|
|
77
|
+
flux-cap now features **Search 2.0** - intelligent, context-aware search that prioritizes:
|
|
78
|
+
- **Recent dumps** (exponential decay scoring)
|
|
79
|
+
- **Same git branch** as your current work
|
|
80
|
+
- **Same working directory** context
|
|
81
|
+
- **Exact tag matches** (coming in v0.8.0)
|
|
82
|
+
- **Quick Brain Dumps**: Capture thoughts instantly with git context
|
|
83
|
+
- **SearchV2**: Multi-signal ranking (fuzzy + recency + git context)
|
|
84
|
+
- **Interactive TUI**: Real-time search with professional interface
|
|
85
|
+
- **Smart Scoring**: See relevance scores and context indicators
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
## 📸 Screenshots
|
|
89
|
+
|
|
90
|
+
### CLI Search
|
|
91
|
+
|
|
51
92
|
|
|
52
|
-
# Search by tags (when implemented in search)
|
|
53
|
-
flux search ideas
|
|
54
|
-
flux search tasks
|
|
55
93
|
|
|
56
|
-
|
|
57
|
-
flux
|
|
94
|
+
### Interactive TUI
|
|
95
|
+
)
|
|
96
|
+
|
|
97
|
+
|
|
98
|
+
### Search Comparison
|
|
99
|
+
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
```bash
|
|
103
|
+
# Smart context-aware search (NEW in v0.8.0!)
|
|
104
|
+
flux search auth # Prioritizes recent + current branch matches
|
|
105
|
+
|
|
106
|
+
# Coming in v0.8.2: Convenience commands
|
|
107
|
+
flux recent # Last 10 dumps
|
|
108
|
+
flux here # Current branch + directory
|
|
109
|
+
flux notes # All note-tagged dumps
|
|
110
|
+
|
|
58
111
|
```
|
|
59
112
|
|
|
60
113
|
## Features
|
|
@@ -66,12 +119,19 @@ flux search
|
|
|
66
119
|
- Monthly file organization for easy browsing
|
|
67
120
|
- Privacy-first design - you control what gets tracked
|
|
68
121
|
|
|
69
|
-
### Intelligent Search
|
|
70
|
-
-
|
|
71
|
-
- **
|
|
72
|
-
-
|
|
73
|
-
-
|
|
74
|
-
-
|
|
122
|
+
### Intelligent Search 2.0 🚀
|
|
123
|
+
- **Multi-signal ranking**: Combines fuzzy matching, recency, and git context
|
|
124
|
+
- **Smart defaults**: Recent dumps + current branch automatically ranked higher
|
|
125
|
+
- **Context-aware**: Prioritizes dumps from your current branch and directory
|
|
126
|
+
- **Debug mode**: `--debug` flag shows detailed scoring breakdown
|
|
127
|
+
- **Flexible filtering**: `--all`, `--since`, `--branch` flags override smart defaults
|
|
128
|
+
- **Fast & local**: No external APIs, blazing fast search results
|
|
129
|
+
|
|
130
|
+
### Interactive Search
|
|
131
|
+
```bash
|
|
132
|
+
flux u # Open interactive TUI search
|
|
133
|
+
flux ui # Same as above (alias)
|
|
134
|
+
```
|
|
75
135
|
|
|
76
136
|
### Privacy Controls
|
|
77
137
|
- Choose what information to track during setup
|
|
@@ -132,6 +192,7 @@ flux dump --tag bug "found an issue"
|
|
|
132
192
|
flux dump --tag meeting "standup notes"
|
|
133
193
|
```
|
|
134
194
|
|
|
195
|
+
|
|
135
196
|
### Tag Examples
|
|
136
197
|
```bash
|
|
137
198
|
# Ideas for future features
|
|
@@ -329,7 +390,10 @@ src/
|
|
|
329
390
|
|
|
330
391
|
## Roadmap
|
|
331
392
|
|
|
332
|
-
### Phase 2 (Coming Soon)
|
|
393
|
+
### Phase 2 (v0.8.0 - Coming Soon)
|
|
394
|
+
- [ ] Convenience search commands (`flux recent`, `flux here`, `flux notes`)
|
|
395
|
+
- [ ] Tag match scoring integration
|
|
396
|
+
- [ ] Grouped result display by relevance
|
|
333
397
|
- [ ] Enhanced tag-based search filtering
|
|
334
398
|
- [ ] ASCII Pomodoro timer with themes
|
|
335
399
|
- [ ] Visual focus mode display
|