nip/examples/shell-usage.md

1.4 KiB

NIP Shell Usage Examples

Interactive Session Example

$ 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

search text-editor
show vim
install vim --stream stable

Package Management

list
show firefox
remove old-package
update

System Maintenance

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