Skip to content

Commit a7621d6

Browse files
jdillonclaude
andcommitted
docs: complete forge→commando rename in documentation
- Update all docs/ files with forge→commando renames - Change CLI command references: forge → cmdo - Update directory paths: .forge/ → .commando/, ~/.forge → ~/.commando - Update type references: ForgeCommand → CommandoCommand - Update package names: @planet57/forge → @planet57/commando - Preserve GitHub issue URLs as they point to existing issues Related: forge-72c 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 99511c9 commit a7621d6

32 files changed

+723
-729
lines changed

docs/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Forge Documentation
1+
# Commando Documentation
22

33
**Status**: `module-system` branch - 74 tests passing
44

@@ -41,13 +41,13 @@
4141
- **CLI**: Commander.js
4242
- **Logging**: Pino (structured JSON + pretty mode)
4343
- **UI**: chalk, ora, listr2, boxen, cli-table3
44-
- **Config**: YAML (.forge/config.yml)
45-
- **Paths**: XDG-compliant (~/.local/share/forge/)
44+
- **Config**: YAML (.commando/config.yml)
45+
- **Paths**: XDG-compliant (~/.commando/)
4646

4747
---
4848

4949
## Philosophy
5050

5151
*"It's for me mostly, so I like awesome."*
5252

53-
Forge prioritizes delightful UX: beautiful output, clear errors, fast startup, type safety.
53+
Commando prioritizes delightful UX: beautiful output, clear errors, fast startup, type safety.

docs/archive/reference/awesome-cli-experience.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Awesome CLI Experience for Forge
1+
# Awesome CLI Experience for Commando
22

33
**Philosophy**: "It's for me mostly, so I like awesome"
44

@@ -252,20 +252,20 @@ import figlet from 'figlet';
252252

253253
console.log(
254254
chalk.cyan(
255-
figlet.textSync('FORGE', { font: 'ANSI Shadow' })
255+
figlet.textSync('COMMANDO', { font: 'ANSI Shadow' })
256256
)
257257
);
258258
console.log(chalk.gray(' v2.0.0 - Modern deployment tool\n'));
259259
```
260260

261261
**Output:**
262262
```
263-
██████╗ ██████╗ ██████╗ ██████╗ ███████╗
264-
██╔════╝██╔═══██╗██╔══██╗██╔════╝ ██╔════╝
265-
█████╗ ██║ ██║██████╔██║ ███╗█████╗
266-
██╔══╝ ██║ ██║██══██╗██║ ██║██╔══╝
267-
██║ ╚██████╔╝██║ ██║╚██████╔╝███████╗
268-
╚═╝ ╚═════╝ ╚═╝ ╚═╚═════╝ ╚══════╝
263+
██████╗ ██████╗ ██████╗███╗ ████████╗ ███╗ ██╗██████╗ ██████╗
264+
██╔════╝██╔═══██╗████╗ ████║████╗ ████║██╔══██╗████╗ ██║██╔══██╗██╔═══██╗
265+
████║ ██║██████╔██║██╔████╔██║███████║██╔██╗ ██║██║ ██║██║ ██║
266+
████║ ██║██║╚██╔╝██║██║╚██╔╝██║██╔══██║██║╚██╗██║██║ ██║██║ ██║
267+
╚██████╗╚██████╔╝██║ ╚═╝ ██║██║ ╚═╝ ██║██║ ██║██║ ╚████║██████╔╝╚██████╔╝
268+
╚═════╝ ╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═══╝╚═════╝ ═════╝
269269
v2.0.0 - Modern deployment tool
270270
```
271271

@@ -295,7 +295,7 @@ notifier.notify();
295295
╭──────────────────────────────────────────────────╮
296296
│ │
297297
│ Update available: 2.0.0 → 2.1.0 │
298-
│ Run `forge update` to update │
298+
│ Run `cmdo update` to update │
299299
│ │
300300
╰──────────────────────────────────────────────────╯
301301
```
@@ -389,11 +389,11 @@ render(<App />);
389389

390390
```json
391391
{
392-
"name": "forge",
392+
"name": "commando",
393393
"version": "2.0.0-prototype",
394394
"type": "module",
395395
"bin": {
396-
"forge": "./forge"
396+
"cmdo": "./cmdo"
397397
},
398398
"dependencies": {
399399
"commander": "^12.0.0",
@@ -568,7 +568,7 @@ async function listModules() {
568568

569569
console.log(chalk.bold('\nInstalled Modules:\n'));
570570
console.log(table.toString());
571-
console.log(chalk.gray('\nRun ') + chalk.cyan('forge module update') + chalk.gray(' to update modules\n'));
571+
console.log(chalk.gray('\nRun ') + chalk.cyan('cmdo module update') + chalk.gray(' to update modules\n'));
572572
}
573573
```
574574

@@ -584,15 +584,15 @@ Installed Modules:
584584
│ custom │ 1.0.0 │ github:user/repo │ ✓ Up to date │
585585
└─────────────────────┴──────────┴──────────────────┴─────────────────┘
586586
587-
Run forge module update to update modules
587+
Run cmdo module update to update modules
588588
```
589589

590590
---
591591

592592
## Example: Update Notifier
593593

594594
```typescript
595-
// forge entry point
595+
// cmdo entry point
596596
import updateNotifier from 'update-notifier';
597597
import pkg from './package.json' assert { type: 'json' };
598598

@@ -604,7 +604,7 @@ updateNotifier({
604604
isGlobal: true,
605605
message: boxen(
606606
'Update available: ' + chalk.gray('{currentVersion}') + '' + chalk.green('{latestVersion}') + '\n' +
607-
'Run ' + chalk.cyan('forge update') + ' to update',
607+
'Run ' + chalk.cyan('cmdo update') + ' to update',
608608
{
609609
padding: 1,
610610
margin: 1,
@@ -711,7 +711,7 @@ bun pm audit
711711

712712
## Summary: The Awesome Experience
713713

714-
**When you run `forge deploy`:**
714+
**When you run `cmdo deploy`:**
715715

716716
1. 📢 ASCII banner on first run
717717
2. ✓ Update notification if available

docs/archive/reference/cli-framework-comparison.md

Lines changed: 31 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ import { Command } from 'commander';
1616
const program = new Command();
1717

1818
program
19-
.name('forge')
19+
.name('cmdo')
2020
.description('Modern CLI framework')
2121
.version('2.0.0');
2222

@@ -42,8 +42,8 @@ program.parse();
4242

4343
**Auto-generated help:**
4444
```bash
45-
$ forge --help
46-
Usage: forge [options] [command]
45+
$ cmdo --help
46+
Usage: cmdo [options] [command]
4747

4848
Modern CLI framework
4949

@@ -56,8 +56,8 @@ Commands:
5656
deploy [options] <environment> Deploy to environment
5757
help [command] display help for command
5858

59-
$ forge sync --help
60-
Usage: forge sync [options]
59+
$ cmdo sync --help
60+
Usage: cmdo sync [options]
6161

6262
Sync to S3
6363

@@ -92,7 +92,7 @@ Options:
9292
import { cli } from 'cleye';
9393

9494
const argv = cli({
95-
name: 'forge',
95+
name: 'cmdo',
9696
version: '2.0.0',
9797

9898
flags: {
@@ -144,7 +144,7 @@ const argv = cli({
144144
import { Command } from 'cliffy';
145145

146146
await new Command()
147-
.name('forge')
147+
.name('cmdo')
148148
.version('2.0.0')
149149
.command('sync', 'Sync to S3')
150150
.option('-d, --dry-run', 'Preview')
@@ -175,7 +175,7 @@ await new Command()
175175
```typescript
176176
import cac from 'cac';
177177

178-
const cli = cac('forge');
178+
const cli = cac('cmdo');
179179

180180
cli
181181
.command('sync', 'Sync to S3')
@@ -265,7 +265,7 @@ bun add omelette
265265
```typescript
266266
import omelette from 'omelette';
267267

268-
const completion = omelette('forge <command> <subcommand>');
268+
const completion = omelette('cmdo <command> <subcommand>');
269269

270270
completion.on('command', ({ reply }) => {
271271
reply(['sync', 'deploy', 'publish', 'module']);
@@ -280,15 +280,15 @@ completion.init();
280280

281281
**Setup:**
282282
```bash
283-
forge completion >> ~/.bashrc
283+
cmdo completion >> ~/.bashrc
284284
# or
285-
forge completion >> ~/.zshrc
285+
cmdo completion >> ~/.zshrc
286286
```
287287

288288
**Usage:**
289289
```bash
290-
forge <TAB> # → sync, deploy, publish, module
291-
forge sync --<TAB> # → --dry-run, --bucket
290+
cmdo <TAB> # → sync, deploy, publish, module
291+
cmdo sync --<TAB> # → --dry-run, --bucket
292292
```
293293

294294
---
@@ -299,9 +299,9 @@ Fig provides IDE-like autocomplete for terminal (macOS only).
299299

300300
**Create completion spec:**
301301
```typescript
302-
// .fig/forge.ts
302+
// .fig/cmdo.ts
303303
const completionSpec = {
304-
name: "forge",
304+
name: "cmdo",
305305
description: "Modern CLI framework",
306306
subcommands: [
307307
{
@@ -343,7 +343,7 @@ program
343343
## Example: Full Commander Setup
344344

345345
```typescript
346-
// forge
346+
// cmdo
347347
#!/usr/bin/env bun
348348
import { Command } from 'commander';
349349
import { $ } from 'bun';
@@ -352,7 +352,7 @@ import pc from 'picocolors';
352352
const program = new Command();
353353

354354
program
355-
.name('forge')
355+
.name('cmdo')
356356
.description('Modern CLI framework for deployments')
357357
.version('2.0.0');
358358

@@ -395,8 +395,8 @@ website
395395
console.log(pc.blue('Publishing website...'));
396396

397397
// Run other commands
398-
await website.parseAsync(['node', 'forge', 'build'], { from: 'user' });
399-
await website.parseAsync(['node', 'forge', 'sync', ...(options.dryRun ? ['--dry-run'] : [])], { from: 'user' });
398+
await website.parseAsync(['node', 'cmdo', 'build'], { from: 'user' });
399+
await website.parseAsync(['node', 'cmdo', 'sync', ...(options.dryRun ? ['--dry-run'] : [])], { from: 'user' });
400400

401401
console.log(pc.green('') + ' Published!');
402402
});
@@ -412,7 +412,7 @@ module
412412
.option('-g, --global', 'Install globally')
413413
.action(async (name, options) => {
414414
console.log(`Installing module: ${name}`);
415-
await $`bun add @forge-modules/${name}`;
415+
await $`bun add @commando-modules/${name}`;
416416
console.log(pc.green('') + ' Installed');
417417
});
418418

@@ -429,7 +429,7 @@ module
429429
.description('Update modules')
430430
.action(async (name) => {
431431
if (name) {
432-
await $`bun update @forge-modules/${name}`;
432+
await $`bun update @commando-modules/${name}`;
433433
} else {
434434
await $`bun update`;
435435
}
@@ -443,7 +443,7 @@ program
443443
.action(() => {
444444
// Generate completion script
445445
console.log('# Add to ~/.bashrc or ~/.zshrc:');
446-
console.log('eval "$(forge completion)"');
446+
console.log('eval "$(cmdo completion)"');
447447
});
448448

449449
// Parse
@@ -452,8 +452,8 @@ await program.parseAsync(process.argv);
452452

453453
**Usage:**
454454
```bash
455-
$ forge --help
456-
Usage: forge [options] [command]
455+
$ cmdo --help
456+
Usage: cmdo [options] [command]
457457

458458
Modern CLI framework for deployments
459459

@@ -469,8 +469,8 @@ Commands:
469469
completion Generate shell completion
470470
help [command] display help for command
471471

472-
$ forge website --help
473-
Usage: forge website [options] [command]
472+
$ cmdo website --help
473+
Usage: cmdo website [options] [command]
474474

475475
Website deployment commands
476476

@@ -479,7 +479,7 @@ Commands:
479479
publish [options] Full publish (build + sync + invalidate)
480480
help [command] display help for command
481481

482-
$ forge module add aws
482+
$ cmdo module add aws
483483
Installing module: aws
484484
✓ Installed
485485
```
@@ -540,13 +540,13 @@ log.fatal('Fatal error'); // 60
540540

541541
```bash
542542
# JSON logs for production (parseable)
543-
NODE_ENV=production forge deploy > logs.json
543+
NODE_ENV=production cmdo deploy > logs.json
544544

545545
# Pretty logs for development
546-
forge deploy
546+
cmdo deploy
547547

548548
# Pipe to analysis
549-
forge deploy | jq 'select(.level >= 50)' # Errors only
549+
cmdo deploy | jq 'select(.level >= 50)' # Errors only
550550
```
551551

552552
---
@@ -555,7 +555,7 @@ forge deploy | jq 'select(.level >= 50)' # Errors only
555555

556556
```json
557557
{
558-
"name": "forge",
558+
"name": "commando",
559559
"version": "2.0.0-prototype",
560560
"type": "module",
561561
"dependencies": {

docs/archive/reference/reply-vs-nameref-explained.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -249,7 +249,7 @@ function bad_example {
249249
}
250250
```
251251

252-
**3. Forgetting to declare variable first:**
252+
**3. Failing to declare variable first:**
253253
```bash
254254
get_distribution_id dist_id # Error if dist_id doesn't exist!
255255

@@ -340,7 +340,7 @@ dist_id = get_distribution_id() # Just works
340340
1.**More explicit** than Zsh `reply` (function signature shows intent)
341341
2.**More portable** (Bash more common than Zsh)
342342
3.**No global pollution** (caller controls variable names)
343-
4.**Can auto-upgrade** (like current forge does for Bash 4)
343+
4.**Can auto-upgrade** (like current commando does for Bash 4)
344344

345345
**Example pattern:**
346346
```bash
@@ -390,7 +390,7 @@ const value = getValue(); // Natural
390390

391391
---
392392

393-
## Real Forge Example: Website Commands
393+
## Real Commando Example: Website Commands
394394

395395
### Current (OUTPUT_PATTERN):
396396

0 commit comments

Comments
 (0)