76 lines
1.4 KiB
Markdown
76 lines
1.4 KiB
Markdown
# NIP Shell Usage Examples
|
|
|
|
## Interactive Session Example
|
|
|
|
```bash
|
|
$ nip shell
|
|
NIP Shell v0.1.0 - Interactive Package Management
|
|
Type 'help' for available commands, 'exit' to quit
|
|
|
|
🟢 nip> help
|
|
# Shows comprehensive help with all available commands
|
|
|
|
🟢 nip> search firefox
|
|
# Enhanced search with CAS paths and CIDs
|
|
|
|
🟢 nip> install firefox
|
|
# Installation workflow with dependency resolution
|
|
|
|
🟢 nip> track testing
|
|
# Switch to testing track
|
|
🟡 nip:testing>
|
|
|
|
🟡 nip:testing> list
|
|
# List packages with CAS analysis
|
|
|
|
🟡 nip:testing> track stable
|
|
# Switch back to stable
|
|
🟢 nip>
|
|
|
|
🟢 nip> status
|
|
# Show system status
|
|
|
|
🟢 nip> history
|
|
# Show command history
|
|
|
|
🟢 nip> exit
|
|
# Exit the shell
|
|
```
|
|
|
|
## Common Workflows
|
|
|
|
### Package Discovery and Installation
|
|
```bash
|
|
search text-editor
|
|
show vim
|
|
install vim --stream stable
|
|
```
|
|
|
|
### Package Management
|
|
```bash
|
|
list
|
|
show firefox
|
|
remove old-package
|
|
update
|
|
```
|
|
|
|
### System Maintenance
|
|
```bash
|
|
verify firefox
|
|
diagnose blake3:abc123
|
|
status
|
|
```
|
|
|
|
## Advanced Features
|
|
|
|
### CAS Integration
|
|
The shell displays Content Addressable Storage information:
|
|
- CAS paths: `/Programs/firefox/118.0-F21194C0A7BC/`
|
|
- Content IDs: `blake3-F21194C0A7BC`
|
|
|
|
### Track Management
|
|
Switch between different package streams:
|
|
- `stable`: Production-ready packages
|
|
- `testing`: Pre-release packages
|
|
- `dev`: Development packages
|
|
- `lts`: Long-term support packages |