824ad97ef9
- Update root AGENTS.md with regenerative content (144 lines, telegraphic) - Add pkgs/AGENTS.md for package registry conventions (33 lines) - Add docs/AGENTS.md for documentation structure (34 lines) - All files follow telegraphic style, no redundancy with parent - Preserves existing modules/home-manager/AGENTS.md Hierarchy: ./AGENTS.md (root) ├── pkgs/AGENTS.md ├── docs/AGENTS.md └── modules/home-manager/AGENTS.md (existing)
75 lines
2.3 KiB
Markdown
75 lines
2.3 KiB
Markdown
# m3ta-nixpkgs
|
|
|
|
Personal Nix flake repository: custom packages, overlays, NixOS modules, and Home Manager modules.
|
|
|
|
## Features
|
|
|
|
- 🎁 **Custom Packages**: Collection of personal Nix packages
|
|
- 🔄 **Overlays**: Package modifications and enhancements
|
|
- 🐚 **Development Shells**: Pre-configured environments (Python, DevOps)
|
|
- ⚙️ **NixOS Modules**: System-level configuration modules
|
|
- 🏠 **Home Manager Modules**: User-level configuration modules
|
|
- 📚 **Library Functions**: Helper utilities for configuration management
|
|
- ❄️ **Flakes Only**: Modern Nix flakes support (no channels)
|
|
|
|
## Quick Links
|
|
|
|
- 📖 [Full Documentation](./docs)
|
|
- 🚀 [Quick Start Guide](./docs/QUICKSTART.md)
|
|
- 📚 [Architecture](./docs/ARCHITECTURE.md)
|
|
- 🤝 [Contributing](./docs/CONTRIBUTING.md)
|
|
- 📦 [Packages](./docs/packages/)
|
|
- ⚙️ [Modules](./docs/modules/)
|
|
- 📖 [Guides](./docs/guides/)
|
|
|
|
## Installation
|
|
|
|
### Add to Your Flake
|
|
|
|
```nix
|
|
{
|
|
inputs = {
|
|
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
|
|
m3ta-nixpkgs.url = "git+https://code.m3ta.dev/m3tam3re/nixpkgs";
|
|
};
|
|
}
|
|
```
|
|
|
|
### Quick Start
|
|
|
|
```bash
|
|
# Build a package
|
|
nix build git+https://code.m3ta.dev/m3tam3re/nixpkgs#code2prompt
|
|
|
|
# Run a package
|
|
nix run git+https://code.m3ta.dev/m3tam3re/nixpkgs#zellij-ps
|
|
|
|
# List all available packages
|
|
nix flake show git+https://code.m3ta.dev/m3tam3re/nixpkgs
|
|
```
|
|
|
|
## Documentation
|
|
|
|
For detailed usage, module documentation, package references, and contribution guidelines, see the [full documentation](./docs).
|
|
|
|
## Available Packages
|
|
|
|
| Package | Description |
|
|
| ------------------ | ------------------------------------- |
|
|
| `code2prompt` | Convert code to prompts |
|
|
| `hyprpaper-random` | Random wallpaper setter for Hyprpaper |
|
|
| `launch-webapp` | Launch web applications |
|
|
| `mem0` | AI memory assistant with vector storage |
|
|
| `msty-studio` | Msty Studio application |
|
|
| `pomodoro-timer` | Pomodoro timer utility |
|
|
| `tuxedo-backlight` | Backlight control for Tuxedo laptops |
|
|
| `zellij-ps` | Process viewer for Zellij |
|
|
|
|
## License
|
|
|
|
Individual packages may have their own licenses. Check each package's `meta.license` attribute.
|
|
|
|
## Maintainer
|
|
|
|
[@m3tam3re](https://m3ta.dev)
|