# 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