Skip to content

Commit 6d0e92d

Browse files
jdmonacojdmonaco
committed
refactor: Rename global config directory to ~/.config/wireflow
Completes WireFlow rebrand by renaming global configuration directory from ~/.config/workflow/ to ~/.config/wireflow/ for full consistency. Changes (33 files): - Updated all references to global config directory - lib/config.sh: GLOBAL_CONFIG_DIR uses wireflow - Default WIREFLOW_PROMPT_PREFIX: ~/.config/wireflow/prompts - Default WIREFLOW_TASK_PREFIX: ~/.config/wireflow/tasks - Updated all documentation references - Updated test helper common.bash Migration (manual): Users should rename their existing directory: mv ~/.config/workflow ~/.config/wireflow No other changes needed. All projects with .workflow/ directories continue working unchanged. This is part of v0.3.0 breaking changes alongside command and env var renames. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected])
1 parent 72c604d commit 6d0e92d

23 files changed

+101
-101
lines changed

‎README.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ wfw edit analyze-data
5858
wfw run analyze-data --context-file data.csv --stream
5959
```
6060

61-
Your project files and folders are treated as read-only. All `workflow` files are maintained in a `.workflow/` subfolder.
61+
Your project files and folders are treated as read-only. All WireFlow files are maintained in a `.workflow/` subfolder.
6262

6363
## Documentation
6464

@@ -105,7 +105,7 @@ wfw run 02-report --depends-on 01-analysis --stream
105105
Multi-tier cascade with pass-through:
106106

107107
```
108-
Global (~/.config/workflow/config)
108+
Global (~/.config/wireflow/config)
109109
↓
110110
Ancestor Projects (grandparent → parent)
111111
↓
@@ -150,7 +150,7 @@ wfw task -i "Extract action items" --context-file meeting-notes.md
150150

151151
### Global Configuration
152152

153-
Auto-created on first use at `~/.config/workflow/`:
153+
Auto-created on first use at `~/.config/wireflow/`:
154154

155155
- `config` - Global defaults for all projects
156156
- `prompts/base.txt` - Default system prompt

‎RELEASE-NOTES.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,11 +29,11 @@ export WIREFLOW_PROMPT_PREFIX="$HOME/custom/prompts"
2929
export WIREFLOW_TASK_PREFIX="$HOME/custom/tasks"
3030
```
3131

32-
**Preserved:** `.workflow/` directories, `~/.config/workflow/` config location continue working unchanged.
32+
**Preserved:** `.workflow/` directories, `~/.config/wireflow/` config location continue working unchanged.
3333

3434
### ✨ Built-In Task Templates
3535

36-
Eight carefully designed generic task templates provide immediate value for common research and development workflows. Templates are created automatically in `~/.config/workflow/tasks/` on first use.
36+
Eight carefully designed generic task templates provide immediate value for common research and development workflows. Templates are created automatically in `~/.config/wireflow/tasks/` on first use.
3737

3838
**Templates:**
3939
- `summarize`: Concise summary with key points and action items
@@ -69,7 +69,7 @@ wfw new analysis --task summarize
6969

7070
### 🔍 Intelligent Fallback Search
7171

72-
When using custom `WIREFLOW_PROMPT_PREFIX` or `WIREFLOW_TASK_PREFIX`, the tool now automatically searches default locations (`~/.config/workflow/prompts/`, `~/.config/workflow/tasks/`) as fallback, preserving access to built-in prompts and templates.
72+
When using custom `WIREFLOW_PROMPT_PREFIX` or `WIREFLOW_TASK_PREFIX`, the tool now automatically searches default locations (`~/.config/wireflow/prompts/`, `~/.config/wireflow/tasks/`) as fallback, preserving access to built-in prompts and templates.
7373

7474
**Problem Solved:**
7575
- Setting custom PREFIX no longer breaks access to built-in "base" system prompt
@@ -116,7 +116,7 @@ Sophisticated content-aware cache breakpoint placement maximizes prompt caching
116116
Automatic workflow context orientation prompt included as first block in every API request, helping AI assistants understand the workflow structure, content organization, and project hierarchy.
117117

118118
**Implementation:**
119-
- Created automatically at `~/.config/workflow/prompts/meta.txt`
119+
- Created automatically at `~/.config/wireflow/prompts/meta.txt`
120120
- Always included first (before user prompts)
121121
- Not user-configurable (internal implementation)
122122
- No cache_control (too small ~50 tokens, below 1024 minimum)

‎docs/contributing/architecture.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ project-root/
7070
**Multi-tier cascade with pass-through:**
7171

7272
1. Global defaults (hardcoded in `lib/config.sh`)
73-
2. Global config (`~/.config/workflow/config`, auto-created on first use)
73+
2. Global config (`~/.config/wireflow/config`, auto-created on first use)
7474
3. Ancestor project configs (grandparent → parent, oldest to newest)
7575
4. Current project config (`.workflow/config`)
7676
5. Workflow config (`.workflow/<name>/config`)
@@ -180,7 +180,7 @@ Builds JSON content blocks only. Pseudo-XML files optionally created via custom
180180

181181
**Build process (every run):**
182182

183-
1. Load meta prompt from `~/.config/workflow/prompts/meta.txt` (auto-included)
183+
1. Load meta prompt from `~/.config/wireflow/prompts/meta.txt` (auto-included)
184184
2. Create meta JSON block WITHOUT cache_control (too small to cache)
185185
3. Add meta block as first element in `SYSTEM_BLOCKS` array
186186
4. Load user prompts from `$WIREFLOW_PROMPT_PREFIX/{name}.txt`
@@ -218,7 +218,7 @@ Builds JSON content blocks only. Pseudo-XML files optionally created via custom
218218

219219
**Cache breakpoints:** User prompts and project descriptions are cached (most stable), meta and date are not cached (meta too small, date changes daily).
220220

221-
**Meta prompt:** Automatically included as first block, provides workflow structure orientation to AI. Not user-configurable. Created at `~/.config/workflow/prompts/meta.txt` during initialization.
221+
**Meta prompt:** Automatically included as first block, provides workflow structure orientation to AI. Not user-configurable. Created at `~/.config/wireflow/prompts/meta.txt` during initialization.
222222

223223
**Date format:** Date-only (not datetime) prevents minute-by-minute cache invalidation.
224224

‎docs/contributing/implementation.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Technical implementation details, module reference, and code-level specifics for
2828

2929
**Configuration management:**
3030

31-
- `ensure_global_config()` - Create `~/.config/workflow/` on first use
31+
- `ensure_global_config()` - Create `~/.config/wireflow/` on first use
3232
- `create_default_global_config()` - Write default config and base.txt
3333
- `load_global_config()` - Load with pass-through logic
3434
- `extract_config()` - Parse config files (bash variable assignments)

‎docs/getting-started/installation.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -180,14 +180,14 @@ echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrc
180180

181181
#### Option 2: Global Configuration File (Recommended)
182182

183-
On first use, Workflow automatically creates `~/.config/workflow/config` where you can store your API key:
183+
On first use, Workflow automatically creates `~/.config/wireflow/config` where you can store your API key:
184184

185185
```bash
186186
# Run any workflow command to trigger auto-creation
187187
wfw help
188188

189189
# Edit the global config
190-
nano ~/.config/workflow/config
190+
nano ~/.config/wireflow/config
191191
```
192192

193193
Add your API key to the config file:
@@ -201,7 +201,7 @@ ANTHROPIC_API_KEY=sk-ant-...
201201

202202
### Optional: Custom System Prompts
203203

204-
By default, Workflow creates a base system prompt at `~/.config/workflow/prompts/base.txt`. If you want to use a custom prompt directory:
204+
By default, Workflow creates a base system prompt at `~/.config/wireflow/prompts/base.txt`. If you want to use a custom prompt directory:
205205

206206
```bash
207207
export WIREFLOW_PROMPT_PREFIX="$HOME/custom/prompts"
@@ -218,20 +218,20 @@ WIREFLOW_PROMPT_PREFIX=$HOME/custom/prompts
218218
If you plan to use named tasks (see [Execution Guide](../user-guide/execution.md#task-mode-task)), set a directory for task templates:
219219

220220
```bash
221-
export WIREFLOW_TASK_PREFIX="$HOME/.config/workflow/tasks"
221+
export WIREFLOW_TASK_PREFIX="$HOME/.config/wireflow/tasks"
222222
```
223223

224224
Or in the global config:
225225

226226
```bash
227-
WIREFLOW_TASK_PREFIX=$HOME/.config/workflow/tasks
227+
WIREFLOW_TASK_PREFIX=$HOME/.config/wireflow/tasks
228228
```
229229

230230
## First-Run Auto-Configuration
231231

232232
The first time you run any `workflow` command, it will automatically:
233233

234-
1. Create `~/.config/workflow/` directory
234+
1. Create `~/.config/wireflow/` directory
235235
2. Create a default `config` file with sensible defaults
236236
3. Create `prompts/` subdirectory
237237
4. Create a default `prompts/base.txt` system prompt
@@ -247,7 +247,7 @@ Verify your installation is working:
247247
wfw help
248248

249249
# Verify global config was created
250-
ls ~/.config/workflow/
250+
ls ~/.config/wireflow/
251251

252252
# Check API key is configured
253253
wfw config # Run from any directory
@@ -293,7 +293,7 @@ sudo yum install jq
293293
If you get API authentication errors:
294294

295295
- Verify your key is set: `echo $ANTHROPIC_API_KEY`
296-
- Check the global config: `cat ~/.config/workflow/config`
296+
- Check the global config: `cat ~/.config/wireflow/config`
297297
- Ensure the key starts with `sk-ant-`
298298
- Verify the key is active in the Anthropic Console
299299

‎docs/getting-started/quickstart.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -211,8 +211,8 @@ For quick queries without creating workflows:
211211
wfw task -i "What are the main themes in these notes?" --context-file notes.txt
212212

213213
# Named task (create reusable task templates)
214-
mkdir -p ~/.config/workflow/tasks
215-
echo "Summarize the key points in bullet format" > ~/.config/workflow/tasks/summarize.txt
214+
mkdir -p ~/.config/wireflow/tasks
215+
echo "Summarize the key points in bullet format" > ~/.config/wireflow/tasks/summarize.txt
216216
wfw task summarize --context-file notes.txt
217217
```
218218

‎docs/reference/cli-reference.md‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -42,15 +42,15 @@ wfw <subcommand> -h # Quick subcommand help
4242
| Variable | Description | Required | Default |
4343
|----------|-------------|----------|---------|
4444
| `ANTHROPIC_API_KEY` | Anthropic API key | ✅ Yes | None |
45-
| `WIREFLOW_PROMPT_PREFIX` | System prompt directory | No | `~/.config/workflow/prompts` |
46-
| `WIREFLOW_TASK_PREFIX` | Named task directory | No | `~/.config/workflow/tasks` |
45+
| `WIREFLOW_PROMPT_PREFIX` | System prompt directory | No | `~/.config/wireflow/prompts` |
46+
| `WIREFLOW_TASK_PREFIX` | Named task directory | No | `~/.config/wireflow/tasks` |
4747
| `EDITOR` | Text editor for file editing | No | `vi` |
4848

4949
## Configuration Files
5050

5151
| Location | Purpose |
5252
|----------|---------|
53-
| `~/.config/workflow/config` | Global user configuration |
53+
| `~/.config/wireflow/config` | Global user configuration |
5454
| `.workflow/config` | Project-level configuration |
5555
| `.workflow/<name>/config` | Workflow-specific configuration |
5656

@@ -94,7 +94,7 @@ Opens `project.txt` and `config` in `$EDITOR` for editing.
9494

9595
**Global inheritance:**
9696

97-
New projects inherit defaults from `~/.config/workflow/config`:
97+
New projects inherit defaults from `~/.config/wireflow/config`:
9898

9999
- `MODEL`, `TEMPERATURE`, `MAX_TOKENS`
100100
- `SYSTEM_PROMPTS`, `OUTPUT_FORMAT`
@@ -478,7 +478,7 @@ wfw config [<name>] [options]
478478
### Configuration Cascade
479479

480480
```
481-
1. Global: ~/.config/workflow/config
481+
1. Global: ~/.config/wireflow/config
482482
2. Ancestors: Parent project configs (oldest to newest)
483483
3. Project: .workflow/config
484484
4. Workflow: .workflow/<name>/config
@@ -489,7 +489,7 @@ wfw config [<name>] [options]
489489

490490
| Indicator | Meaning |
491491
|-----------|---------|
492-
| `(global)` | From `~/.config/workflow/config` |
492+
| `(global)` | From `~/.config/wireflow/config` |
493493
| `(ancestor:path)` | From ancestor project config |
494494
| `(project)` | From `.workflow/config` |
495495
| `(workflow)` | From `.workflow/<name>/config` |
@@ -515,7 +515,7 @@ Current Workflow:
515515
Location: ~/projects/research/.workflow/01-analysis
516516
517517
Configuration Cascade:
518-
Global: ~/.config/workflow/config
518+
Global: ~/.config/wireflow/config
519519
Ancestor: ~/projects/.workflow/config
520520
Project: ~/projects/research/.workflow/config
521521
Workflow: ~/projects/research/.workflow/01-analysis/config
@@ -739,8 +739,8 @@ Otherwise runs in standalone mode with global config only.
739739
Create reusable task templates in `$WIREFLOW_TASK_PREFIX/`:
740740

741741
```bash
742-
mkdir -p ~/.config/workflow/tasks
743-
echo "Summarize the key points" > ~/.config/workflow/tasks/summarize.txt
742+
mkdir -p ~/.config/wireflow/tasks
743+
echo "Summarize the key points" > ~/.config/wireflow/tasks/summarize.txt
744744
wfw task summarize --context-file notes.md
745745
```
746746

‎docs/reference/project-structure.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -247,7 +247,7 @@ Workflow directory containing all workflow-specific files.
247247

248248
## Global Configuration
249249

250-
### `~/.config/workflow/`
250+
### `~/.config/wireflow/`
251251

252252
Global user configuration directory.
253253

@@ -258,7 +258,7 @@ Global user configuration directory.
258258
**Contents:**
259259

260260
```
261-
~/.config/workflow/
261+
~/.config/wireflow/
262262
├── config # Global configuration
263263
├── prompts/ # System prompts
264264
│ ├── base.txt # Default prompt (auto-created)
@@ -270,7 +270,7 @@ Global user configuration directory.
270270
└── extract.txt
271271
```
272272

273-
### `~/.config/workflow/config`
273+
### `~/.config/wireflow/config`
274274

275275
Global configuration file.
276276

@@ -280,7 +280,7 @@ Global configuration file.
280280

281281
**See:** [Configuration Guide](../user-guide/configuration.md)
282282

283-
### `~/.config/workflow/prompts/`
283+
### `~/.config/wireflow/prompts/`
284284

285285
System prompt directory.
286286

@@ -292,7 +292,7 @@ System prompt directory.
292292

293293
**See:** [System Prompts Guide](../user-guide/system-prompts.md)
294294

295-
### `~/.config/workflow/tasks/`
295+
### `~/.config/wireflow/tasks/`
296296

297297
Optional named task directory.
298298

@@ -459,8 +459,8 @@ Disk usage grows with iterations. Periodically clean old backups if needed.
459459
### Recommended Permissions
460460

461461
```bash
462-
chmod 700 ~/.config/workflow/ # User-only access to global config
463-
chmod 600 ~/.config/workflow/config # Protect API key
462+
chmod 700 ~/.config/wireflow/ # User-only access to global config
463+
chmod 600 ~/.config/wireflow/config # Protect API key
464464
chmod 755 .workflow/ # Project dir
465465
chmod 644 .workflow/config # Config files
466466
chmod 644 .workflow/*/task.txt

‎docs/reference/streaming.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,7 @@ Response saved to: .workflow/analysis/output.md
131131
**In global config:**
132132

133133
```bash
134-
# ~/.config/workflow/config
134+
# ~/.config/wireflow/config
135135
STREAM_MODE=true # or false
136136
```
137137

‎docs/troubleshooting.md‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ sudo yum install jq curl
5555
export ANTHROPIC_API_KEY="sk-ant-..."
5656

5757
# Or add to global config
58-
nano ~/.config/workflow/config
58+
nano ~/.config/wireflow/config
5959
# Add: ANTHROPIC_API_KEY=sk-ant-...
6060
```
6161

@@ -217,10 +217,10 @@ ls $WIREFLOW_PROMPT_PREFIX/
217217
echo $WIREFLOW_PROMPT_PREFIX
218218

219219
# Check config
220-
grep WIREFLOW_PROMPT_PREFIX ~/.config/workflow/config
220+
grep WIREFLOW_PROMPT_PREFIX ~/.config/wireflow/config
221221

222222
# Create missing prompt
223-
nano ~/.config/workflow/prompts/custom.txt
223+
nano ~/.config/wireflow/prompts/custom.txt
224224
```
225225

226226
## Execution Issues
@@ -392,7 +392,7 @@ ls .workflow/analysis/output/
392392

393393
### Global Config Not Created
394394

395-
**Problem:** `~/.config/workflow/` doesn't exist
395+
**Problem:** `~/.config/wireflow/` doesn't exist
396396

397397
**Solution:**
398398

@@ -401,7 +401,7 @@ ls .workflow/analysis/output/
401401
wfw help
402402

403403
# Or create manually
404-
mkdir -p ~/.config/workflow/prompts
404+
mkdir -p ~/.config/wireflow/prompts
405405
wfw init /tmp/test-project # Triggers creation
406406
```
407407

@@ -413,7 +413,7 @@ wfw init /tmp/test-project # Triggers creation
413413

414414
```bash
415415
# Check bash syntax
416-
bash -n ~/.config/workflow/config
416+
bash -n ~/.config/wireflow/config
417417

418418
# Common issues:
419419
# - Missing quotes around values with spaces
@@ -477,8 +477,8 @@ echo $WIREFLOW_TASK_PREFIX
477477
ls $WIREFLOW_TASK_PREFIX/summarize.txt
478478

479479
# Create task
480-
mkdir -p ~/.config/workflow/tasks
481-
echo "Summarize the content" > ~/.config/workflow/tasks/summarize.txt
480+
mkdir -p ~/.config/wireflow/tasks
481+
echo "Summarize the content" > ~/.config/wireflow/tasks/summarize.txt
482482
```
483483

484484
### Task Output to File Fails
@@ -595,10 +595,10 @@ command -v curl > /dev/null && echo "✓ curl installed" || echo "✗ curl missi
595595
[ -d ".workflow" ] && echo "✓ In workflow project" || echo "✗ Not in project"
596596

597597
# Check config
598-
[ -f ~/.config/workflow/config ] && echo "✓ Global config exists" || echo "✗ No global config"
598+
[ -f ~/.config/wireflow/config ] && echo "✓ Global config exists" || echo "✗ No global config"
599599

600600
# Check prompts
601-
[ -d ~/.config/workflow/prompts ] && echo "✓ Prompt directory exists" || echo "✗ No prompt directory"
601+
[ -d ~/.config/wireflow/prompts ] && echo "✓ Prompt directory exists" || echo "✗ No prompt directory"
602602
```
603603

604604
## See Also

0 commit comments

Comments
 (0)