Zshrc Manager

View and manage your ~/.zshrc from Raycast

Eitel Dagnin

689 Installs

Install Extension

Overview

Zshrc Manager

A powerful Raycast extension for managing your ~/.zshrc configuration file

View, organize, and edit your shell aliases, exports, functions, and more with an intuitive interface.

Features • Commands • Usage • Configuration • Development • Contributing

✨ Features

📊	Statistics & Overview	Comprehensive statistics of your zshrc configuration with counts of aliases, exports, functions, plugins, and more
🖥️	Alias Management	Browse, add, edit, and search aliases organized by sections with full validation
📦	Export Management	Manage environment variable exports with search by variable name or value
⚙️	Advanced Config	View and manage functions, plugins, sources, evals, setopts, PATH entries, and keybindings
🔍	Smart Search	Search across all content types with real-time filtering by section, name, command, or value
📝	Section Management	View zshrc content organized by logical sections with detailed breakdowns
💾	Backup & Restore	Automatic backups before edits with one-click restore functionality
↩️	Undo History	Session-based undo/redo for all edit operations

🚀 Commands

Command	Description	Shortcut
📊 Zshrc Statistics	Overview of your entire zshrc configuration	—
📁 Sections	Browse and manage logical sections	—
🖥️ Aliases	Manage shell aliases	—
📦 Exports	Manage environment variable exports	—
⚡ Functions	View and manage shell functions	—
🔌 Plugins	Manage zsh plugins	—
📂 Sources	View source commands	—
🔄 Evals	Manage eval commands	—
⚙️ Setopts	View setopt configurations	—
🛤️ PATH Entries	Manage PATH modifications	—
⌨️ Keybindings	View bindkey configurations	—
🔍 Global Search	Search across all content types	—
🏥 Health Check	Diagnose configuration issues	—
💾 Backup Manager	Manage zshrc backups	—

📖 Usage

Getting Started

Install the extension from the Raycast Store
Open any command to view your zshrc configuration
Use search to find specific entries
Use actions to add, edit, or copy content

📝 Adding New Aliases

Open the Aliases command
Press Cmd+N or click "Add New Alias"
Enter the alias name and command
Select or create a section
Save to add to your zshrc file

# Example: Add a quick git status alias
alias gs='git status'

📦 Managing Exports

Open the Exports command
Press Cmd+N to add a new export
Enter the variable name (uppercase recommended) and value
Save to update your zshrc file

# Example: Set your default editor
export EDITOR=code

🔍 Searching Content

Use the search bar in any command
Search by name, command, section, or value
Results update in real-time as you type
Use Global Search to search across all entry types at once

⚙️ Configuration

Built-in Section Formats

The extension automatically detects sections using these patterns:

Format	Example	Description
Labeled	`# Section: Name`	Simple labeled sections
Dashed	`# --- Name --- #`	Dashed delimiter sections
Bracketed	`# [Name]`	Bracketed sections
Hash	`## Name`	Double-hash sections
Tags	`# @start Name` / `# @end Name`	Custom start/end tags
Functions	`myFunc() { ... }`	Function definitions

🔧 Custom Section Patterns

Configure custom patterns in Raycast Preferences:

Open Raycast Preferences
Go to Extensions → Zshrc Manager
Configure your custom patterns

Custom Header Pattern

Enable Custom Header Pattern: Toggle to enable
Custom Header Pattern: Regex with one capture group for section name

# Example: Match "# My Section"
^#\s+(.+)$

Custom Start/End Patterns

Enable Custom Start/End Patterns: Toggle to enable
Custom Start Pattern: Regex with one capture group
Custom End Pattern: Regex for end markers

# Start pattern
^#\s*start\s+(.+)$

# End pattern
^#\s*end\s+(.+)$

Pattern Requirements

Patterns must include exactly one capture group (...) for the section name
Patterns are automatically anchored to the start of the line (^)
Matching is case-insensitive
Invalid patterns are ignored, falling back to defaults

⌨️ Keyboard Shortcuts

Shortcut	Action
`Cmd+N`	Add new alias/export
`Cmd+R`	Refresh data
`Cmd+O`	Open ~/.zshrc in default editor
`Cmd+C`	Copy selected content
`Cmd+Z`	Undo last change
`Cmd+Shift+Z`	Redo

📋 Requirements

Requirement	Details
🐚 Shell	Zsh (Z shell)
📄 File	`~/.zshrc` configuration file
🔐 Permissions	Read/write access to home directory

🛡️ Error Handling

Scenario	Behavior
📁 File Not Found	Graceful fallback with cached data
🔒 Permission Errors	Clear error messages with suggestions
📏 Large Files	Automatic content truncation (1MB limit)
✅ Validation	Input validation for aliases and exports
💾 Backups	Automatic `.zshrc.bak` before writes

🔧 Development

# Install dependencies
npm install

# Development mode
npm run dev

# Build
npm run build

# Testing
npm run test
npm run test:coverage

# Linting
npm run lint
npm run fix-lint

📁 Project Structure

src/
├── __tests__/          # Test files (mirror src structure)
├── components/         # Reusable UI components
├── data/               # Static data (templates)
├── hooks/              # React hooks for state management
├── lib/                # Core business logic
├── types/              # TypeScript type definitions
├── utils/              # Pure utility functions
└── *.tsx               # UI components (commands)

🤝 Contributing

We welcome contributions!

Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Ensure all tests pass
Submit a pull request

📄 License

MIT License

🔗 Links

Resource	Link
🐛 Issues	GitHub Issues
📚 Documentation	Raycast Developer Docs
📝 Changelog	CHANGELOG.md
⚠️ Limitations	LIMITATIONS.md

Made with ❤️ for the Raycast community

Compatibility

macOS

Subscribe to our newsletter.

Get product updates and news in your inbox. No spam.

Zshrc Manager

View and manage your ~/.zshrc from Raycast

Eitel Dagnin

689 Installs

Install Extension

Overview

Zshrc Manager

A powerful Raycast extension for managing your ~/.zshrc configuration file

View, organize, and edit your shell aliases, exports, functions, and more with an intuitive interface.

Features • Commands • Usage • Configuration • Development • Contributing

✨ Features

📊	Statistics & Overview	Comprehensive statistics of your zshrc configuration with counts of aliases, exports, functions, plugins, and more
🖥️	Alias Management	Browse, add, edit, and search aliases organized by sections with full validation
📦	Export Management	Manage environment variable exports with search by variable name or value
⚙️	Advanced Config	View and manage functions, plugins, sources, evals, setopts, PATH entries, and keybindings
🔍	Smart Search	Search across all content types with real-time filtering by section, name, command, or value
📝	Section Management	View zshrc content organized by logical sections with detailed breakdowns
💾	Backup & Restore	Automatic backups before edits with one-click restore functionality
↩️	Undo History	Session-based undo/redo for all edit operations

🚀 Commands

Command	Description	Shortcut
📊 Zshrc Statistics	Overview of your entire zshrc configuration	—
📁 Sections	Browse and manage logical sections	—
🖥️ Aliases	Manage shell aliases	—
📦 Exports	Manage environment variable exports	—
⚡ Functions	View and manage shell functions	—
🔌 Plugins	Manage zsh plugins	—
📂 Sources	View source commands	—
🔄 Evals	Manage eval commands	—
⚙️ Setopts	View setopt configurations	—
🛤️ PATH Entries	Manage PATH modifications	—
⌨️ Keybindings	View bindkey configurations	—
🔍 Global Search	Search across all content types	—
🏥 Health Check	Diagnose configuration issues	—
💾 Backup Manager	Manage zshrc backups	—

📖 Usage

Getting Started

Install the extension from the Raycast Store
Open any command to view your zshrc configuration
Use search to find specific entries
Use actions to add, edit, or copy content

📝 Adding New Aliases

Open the Aliases command
Press Cmd+N or click "Add New Alias"
Enter the alias name and command
Select or create a section
Save to add to your zshrc file

# Example: Add a quick git status alias
alias gs='git status'

📦 Managing Exports

Open the Exports command
Press Cmd+N to add a new export
Enter the variable name (uppercase recommended) and value
Save to update your zshrc file

# Example: Set your default editor
export EDITOR=code

🔍 Searching Content

Use the search bar in any command
Search by name, command, section, or value
Results update in real-time as you type
Use Global Search to search across all entry types at once

⚙️ Configuration

Built-in Section Formats

The extension automatically detects sections using these patterns:

Format	Example	Description
Labeled	`# Section: Name`	Simple labeled sections
Dashed	`# --- Name --- #`	Dashed delimiter sections
Bracketed	`# [Name]`	Bracketed sections
Hash	`## Name`	Double-hash sections
Tags	`# @start Name` / `# @end Name`	Custom start/end tags
Functions	`myFunc() { ... }`	Function definitions

🔧 Custom Section Patterns

Configure custom patterns in Raycast Preferences:

Open Raycast Preferences
Go to Extensions → Zshrc Manager
Configure your custom patterns

Custom Header Pattern

Enable Custom Header Pattern: Toggle to enable
Custom Header Pattern: Regex with one capture group for section name

# Example: Match "# My Section"
^#\s+(.+)$

Custom Start/End Patterns

Enable Custom Start/End Patterns: Toggle to enable
Custom Start Pattern: Regex with one capture group
Custom End Pattern: Regex for end markers

# Start pattern
^#\s*start\s+(.+)$

# End pattern
^#\s*end\s+(.+)$

Pattern Requirements

Patterns must include exactly one capture group (...) for the section name
Patterns are automatically anchored to the start of the line (^)
Matching is case-insensitive
Invalid patterns are ignored, falling back to defaults

⌨️ Keyboard Shortcuts

Shortcut	Action
`Cmd+N`	Add new alias/export
`Cmd+R`	Refresh data
`Cmd+O`	Open ~/.zshrc in default editor
`Cmd+C`	Copy selected content
`Cmd+Z`	Undo last change
`Cmd+Shift+Z`	Redo

📋 Requirements

Requirement	Details
🐚 Shell	Zsh (Z shell)
📄 File	`~/.zshrc` configuration file
🔐 Permissions	Read/write access to home directory

🛡️ Error Handling

Scenario	Behavior
📁 File Not Found	Graceful fallback with cached data
🔒 Permission Errors	Clear error messages with suggestions
📏 Large Files	Automatic content truncation (1MB limit)
✅ Validation	Input validation for aliases and exports
💾 Backups	Automatic `.zshrc.bak` before writes

🔧 Development

# Install dependencies
npm install

# Development mode
npm run dev

# Build
npm run build

# Testing
npm run test
npm run test:coverage

# Linting
npm run lint
npm run fix-lint

📁 Project Structure

src/
├── __tests__/          # Test files (mirror src structure)
├── components/         # Reusable UI components
├── data/               # Static data (templates)
├── hooks/              # React hooks for state management
├── lib/                # Core business logic
├── types/              # TypeScript type definitions
├── utils/              # Pure utility functions
└── *.tsx               # UI components (commands)

🤝 Contributing

We welcome contributions!

Fork the repository
Create a feature branch
Make your changes
Add tests for new functionality
Ensure all tests pass
Submit a pull request

📄 License

MIT License

🔗 Links

Resource	Link
🐛 Issues	GitHub Issues
📚 Documentation	Raycast Developer Docs
📝 Changelog	CHANGELOG.md
⚠️ Limitations	LIMITATIONS.md

Made with ❤️ for the Raycast community

Compatibility

macOS