11# Standard Library Example (Git URL)
22
3- This example demonstrates using the ` @planet57/forge -standard ` package loaded from a ** git repository** to load reusable command modules.
3+ This example demonstrates using the ` @planet57/commando -standard ` package loaded from a ** git repository** to load reusable command modules.
44
55## What This Shows
66
77- Loading modules from ** git repositories** using ` git+ssh:// ` protocol
88- SSH authentication for private repositories
9- - Package submodule syntax: ` @planet57/forge -standard/hello `
9+ - Package submodule syntax: ` @planet57/commando -standard/hello `
1010- Group name derived from submodule: ` hello `
1111- Auto-install from git on first use
1212
@@ -29,7 +29,7 @@ cd examples/standard-git
2929# Use local dev CLI (./cmdo symlink ensures correct version)
3030./cmdo --help
3131
32- # Use commands from forge -standard
32+ # Use commands from commando -standard
3333./cmdo hello greet World
3434./cmdo hello greet Jason
3535./cmdo hello info
@@ -44,7 +44,7 @@ cd examples/standard-git
4444``` bash
4545$ ./cmdo --help
4646Installing dependencies...
47- + @planet57/forge -standard@git+ssh://git@github.com/jdillon/forge -standard.git
47+ + @planet57/commando -standard@git+ssh://git@github.com/jdillon/commando -standard.git
4848Restarting to pick up dependency changes...
4949
5050Usage: cmdo [options] [command]
@@ -59,20 +59,20 @@ Commands:
5959``` bash
6060$ ./cmdo hello greet Jason
6161Hello, Jason!
62- Loaded from forge -standard package
62+ Loaded from commando -standard package
6363
6464$ ./cmdo hello info
65- Module: @planet57/forge -standard/hello
65+ Module: @planet57/commando -standard/hello
6666Version: 0.1.0
6767Commands: greet, info
6868```
6969
7070## How It Works
7171
72- 1 . ** Config declares dependency** : ` git+ssh://git@github.com/jdillon/forge -standard.git `
73- 2 . ** Auto-install** : On first run, Commando clones the git repo and installs to ` ~/.commando/node_modules/@planet57/forge -standard/ `
72+ 1 . ** Config declares dependency** : ` git+ssh://git@github.com/jdillon/commando -standard.git `
73+ 2 . ** Auto-install** : On first run, Commando clones the git repo and installs to ` ~/.commando/node_modules/@planet57/commando -standard/ `
74743 . ** SSH authentication** : Uses your SSH keys (~ /.ssh/id_rsa) automatically
75- 4 . ** Module loading** : ` @planet57/forge -standard/hello ` resolves to ` hello.ts `
75+ 4 . ** Module loading** : ` @planet57/commando -standard/hello ` resolves to ` hello.ts `
76765 . ** Group name** : Last path segment ` hello ` becomes the command group
77776 . ** Commands registered** : ` greet ` and ` info ` commands under ` hello ` group
78787 . ** Restart mechanism** : Exit code 42 signals wrapper to restart after dependency install
@@ -84,27 +84,27 @@ See `.commando/config.yml`:
8484``` yaml
8585dependencies :
8686 # Git URL with SSH authentication
87- - git+ssh://git@github.com/jdillon/forge -standard.git
87+ - git+ssh://git@github.com/jdillon/commando -standard.git
8888
8989modules :
90- - " @planet57/forge -standard/hello"
90+ - " @planet57/commando -standard/hello"
9191` ` `
9292
9393## Git URL Formats Supported
9494
9595**SSH (recommended for private repos):**
9696` ` ` yaml
9797dependencies :
98- - git+ssh://git@github.com/jdillon/forge -standard.git
99- - git+ssh://git@github.com/jdillon/forge -standard.git#main # Specific branch
100- - git+ssh://git@github.com/jdillon/forge -standard.git#v1.0.0 # Specific tag
98+ - git+ssh://git@github.com/jdillon/commando -standard.git
99+ - git+ssh://git@github.com/jdillon/commando -standard.git#main # Specific branch
100+ - git+ssh://git@github.com/jdillon/commando -standard.git#v1.0.0 # Specific tag
101101` ` `
102102
103103**HTTPS (public repos):**
104104` ` ` yaml
105105dependencies :
106- - git+https://github.com/jdillon/forge -standard.git
107- - github:jdillon/forge -standard # GitHub shorthand (HTTPS only)
106+ - git+https://github.com/jdillon/commando -standard.git
107+ - github:jdillon/commando -standard # GitHub shorthand (HTTPS only)
108108` ` `
109109
110110## Related Examples
@@ -114,8 +114,8 @@ dependencies:
114114
115115# # Related Files
116116
117- - **forge -standard repo**: https://github.com/jdillon/forge -standard
118- - **Installed location**: `~/.commando/node_modules/@planet57/forge -standard/`
117+ - **commando -standard repo**: https://github.com/jdillon/commando -standard
118+ - **Installed location**: `~/.commando/node_modules/@planet57/commando -standard/`
119119- **Module resolver**: `lib/module-resolver.ts`
120120- **Package manager**: `lib/package-manager.ts`
121121- **Phase 2 & 3 docs**: `docs/wip/module-system/`
@@ -125,13 +125,13 @@ dependencies:
125125**Error: "Failed to install git+ssh://..."**
126126- Check SSH keys : ` ssh -T git@github.com`
127127- Ensure key is added to GitHub : https://github.com/settings/keys
128- - Try manual install : ` cd ~/.commando && bun add git+ssh://git@github.com/jdillon/forge -standard.git`
128+ - Try manual install : ` cd ~/.commando && bun add git+ssh://git@github.com/jdillon/commando -standard.git`
129129
130130**Error: "Permission denied (publickey)"**
131131- SSH key not configured or not added to ssh-agent
132132- Run : ` ssh-add ~/.ssh/id_rsa`
133133
134134**Module not loading after install:**
135135- Check commando home : ` ls ~/.commando/node_modules/@planet57/`
136- - Verify package.json has correct name : ` cat ~/.commando/node_modules/@planet57/forge -standard/package.json`
136+ - Verify package.json has correct name : ` cat ~/.commando/node_modules/@planet57/commando -standard/package.json`
137137- Try clean reinstall : Remove from commando home and run `./cmdo --help` again
0 commit comments