{"id":49012943,"url":"https://github.com/fr3on/aporia","last_synced_at":"2026-04-22T03:00:36.158Z","repository":{"id":352305353,"uuid":"1214598305","full_name":"fr3on/aporia","owner":"fr3on","description":"Aporia: The adaptive, high-performance Zsh theme for professionals. Context-aware, polyglot-ready, and zero-dependency. Built-in autocomplete \u0026 syntax highlighting.","archived":false,"fork":false,"pushed_at":"2026-04-20T21:51:50.000Z","size":9020,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-21T02:03:02.023Z","etag":null,"topics":["adaptive-ui","autosuggestions","developer-tools","minimalist","nerd-fonts","oh-my-zsh","powerline","productivity","shell","syntax-highlighting","terminal","zsh","zsh-theme"],"latest_commit_sha":null,"homepage":"https://0x200.com/writing/aporia-engineering-the-high-fidelity-terminal/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fr3on.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-18T19:44:44.000Z","updated_at":"2026-04-20T21:51:53.000Z","dependencies_parsed_at":null,"dependency_job_id":"0b729e9b-6b04-4068-b088-e3c0e365805a","html_url":"https://github.com/fr3on/aporia","commit_stats":null,"previous_names":["fr3on/aporia"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/fr3on/aporia","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fr3on%2Faporia","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fr3on%2Faporia/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fr3on%2Faporia/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fr3on%2Faporia/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fr3on","download_url":"https://codeload.github.com/fr3on/aporia/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fr3on%2Faporia/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32119065,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T00:31:26.853Z","status":"online","status_checked_at":"2026-04-22T02:00:05.693Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adaptive-ui","autosuggestions","developer-tools","minimalist","nerd-fonts","oh-my-zsh","powerline","productivity","shell","syntax-highlighting","terminal","zsh","zsh-theme"],"created_at":"2026-04-19T00:15:01.270Z","updated_at":"2026-04-22T03:00:36.145Z","avatar_url":"https://github.com/fr3on.png","language":"Shell","funding_links":[],"categories":["Themes"],"sub_categories":["ZSH on Windows"],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eAporia\u003c/h1\u003e\n  \u003cp\u003e\u003cb\u003eDeep Blue · Context-Aware · High-Performance\u003c/b\u003e\u003c/p\u003e\n  \u003cp\u003eA professional Zsh theme designed for developers who demand a state-of-the-art terminal environment.\u003c/p\u003e\n\n  \u003ca href=\"https://github.com/fr3on/aporia/releases/latest\"\u003e\u003cimg src=\"https://img.shields.io/github/v/release/fr3on/aporia?style=flat-square\u0026logo=github\u0026color=blue\" alt=\"Latest Release\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/zsh-%3E%3D5.2-orange?style=flat-square\u0026logo=zsh\" alt=\"Zsh Version\"\u003e\n  \u003ca href=\"https://github.com/fr3on/aporia/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/fr3on/aporia/ci.yml?style=flat-square\u0026logo=github-actions\" alt=\"CI Status\"\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/fr3on/aporia?style=flat-square\u0026color=brightgreen\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003cimg src=\"screenshots/preview.png\" width=\"800\" alt=\"Aporia Theme Preview\"\u003e\n\u003c/div\u003e\n\n\n## The Aporia Philosophy\nAporia isn't just a prompt; it's a **context-aware environment**. It adapts dynamically to your project, your privileges, and your operating system—staying minimal when you're busy and providing deep insights when you need them.\n\n### Core Features\n*   **Asynchronous Prompt Engine**: Native non-blocking background workers (`zle -F`) for instant terminal snappiness.\n*   **Theme Presets**: Switch between `deep_blue`, `light`, and `amber` color palettes via `AP_THEME`.\n*   **Adaptive Branding**: Official high-fidelity icons for macOS, Debian, Ubuntu, Arch, and more.\n*   **Polyglot Awareness**: Real-time project detection for **Go, Rust, Python, Node, Ruby, PHP, Java, and C++**.\n*   **Contextual Intelligence**: New Git stash tracking and dedicated segments for Virtual Environments and Docker.\n*   **Aporia Essentials**: Built-in support for ghost-text **Autosuggestions** and live **Syntax Highlighting**.\n\n\n## Compatibility\n\nAporia is designed for native performance across Unix-like systems. It is formally compatible with:\n\n*   **macOS**: Native optimized support via Homebrew or standard install.\n*   **Linux**: Full support for Debian, Ubuntu, Arch, Fedora, Alpine, and more.\n*   **Windows**: Supported via **WSL2** (requires a Nerd Font installed on the Windows side).\n\n**Requirements**:\n- **Zsh**: Version 5.2 or newer.\n- **Font**: A [Nerd Font](https://www.nerdfonts.com) (e.g., JetBrainsMono, Hack) for high-fidelity icons.\n\n\n## Installation\n\n### 1-Click Install (Universal)\nThe fastest way to get started on any system:\n```bash\ncurl -fsSL https://raw.githubusercontent.com/fr3on/aporia/main/install.sh | zsh\n```\n\n### Homebrew (macOS)\nThe professional way to manage Aporia on your Mac:\n```bash\nbrew tap fr3on/aporia https://github.com/fr3on/aporia\nbrew install aporia\n```\n*Note: Make sure to add `source $(brew --prefix)/share/aporia/aporia.zsh-theme` to your `.zshrc`.*\n\n### Plugin Managers\n| Manager | Configuration |\n| :--- | :--- |\n| **Oh My Zsh** | `git clone https://github.com/fr3on/aporia $ZSH_CUSTOM/themes/aporia`\u003cbr/\u003e*Set `ZSH_THEME=\"aporia/aporia\"` in `.zshrc`* |\n| **Zinit** | `zinit ice pick\"aporia.zsh-theme\"; zinit light fr3on/aporia` |\n| **Antigen** | `antigen theme fr3on/aporia` |\n| **Zplug** | `zplug \"fr3on/aporia\", as:theme` |\n\n\n## Plugin System\n\nAporia features a modular plugin system that keeps your prompt fast while giving you the tools you need. Plugins are opt-in and handled via the `AP_PLUGINS` array.\n\n\u003e [!TIP]\n\u003e **New to Aporia plugins?** Check out our **[Detailed Plugin Guide (with examples)](PLUGINS.md)** to see how each feature works!\n\n### Quick Start\nThe easiest way to enable features is to use the built-in activation command:\n```zsh\naporia-activate-plugin \u003cname\u003e\n```\n\nAlternatively, you can manually define the `AP_PLUGINS` array in your `~/.zshrc` before the theme is sourced:\n```zsh\nAP_PLUGINS=(sudo docker-ctx fast-syntax-highlighting)\nsource ~/.aporia.zsh-theme\n```\n\n### Available Plugins\n\n| Plugin | Description | Depends on | Install |\n|---|---|---|---|\n| `history-substring-search` | `↑`/`↓` searches history by typed prefix | none | `aporia-install-plugin history-substring-search` |\n| `autopair` | Auto-closes `\"`, `'`, `(`, `[`, `` ` `` | none | `aporia-install-plugin autopair` |\n| `you-should-use` | Reminds you when a shorter alias exists | none | `aporia-install-plugin you-should-use` |\n| `fast-syntax-highlighting` | Drop-in FSH replacement (faster, themeable) | none | `aporia-install-plugin fast-syntax-highlighting` |\n| `fzf-tab` | Replaces tab completion menu with fzf | `fzf` | `aporia-install-plugin fzf-tab` |\n| `fzf-history` | Replaces `Ctrl+R` with fzf history browser | `fzf` | `aporia-install-plugin fzf-history` |\n| `docker-ctx` | Shows Docker context in prompt (no subprocess) | none | bundled |\n| `kube-ctx` | Shows kubectl context:namespace (no kubectl) | `kubectl` on PATH | bundled |\n| `aws-profile` | Shows `$AWS_PROFILE` + region, red on prod | none | bundled |\n| `proxmox` | Detects Proxmox Host nodes and Guest VMs | none | bundled |\n| `autoswitch-venv` | Auto-activates virtualenv on `cd` | none | `aporia-install-plugin autoswitch-venv` |\n| `nix-shell` | Shows active Nix/devenv shell | none | bundled |\n| `forgit` | `fzf`-powered interactive `git` workflows | `fzf`, `git` | `aporia-install-plugin forgit` |\n| `sudo` | Double `ESC` → prepend `sudo` | none | bundled |\n\n### Plugin Management\n*   **`aporia-install-plugin \u003cname\u003e`**: Installs a third-party plugin from its upstream repository.\n*   **`aporia-activate-plugin \u003cname\u003e`**: Installs (if missing) and activates a plugin in your current session and `~/.zshrc`.\n*   **`aporia-activate-all`**: Automatically activates all plugins currently installed on your system.\n*   **`aporia-update-plugins`**: Pulls the latest changes for all your installed plugins.\n*   **`aporia-list-plugins`**: Shows which plugins are installed and which are currently active.\n\n\n## Configuration\nOverride these variables in your `~/.zshrc` *before* the theme is sourced to customize your experience:\n\n| Variable | Default | Description |\n| :--- | :--- | :--- |\n| `AP_THEME` | `deep_blue` | Color preset: `deep_blue`, `light`, or `amber` |\n| `AP_USE_NERD_FONT` | `1` | Set to `0` for fallback Unicode characters |\n| `AP_ASCII_FALLBACK` | `0` | Set to `1` to use ASCII separators instead of Nerd Fonts |\n| `AP_SHOW_SSH` | `1` | Show SSH context (user@host) |\n| `AP_SHOW_GIT` | `1` | Show Git status and upstream info |\n| `AP_SHOW_LANGS` | `1` | Show language versions (only inside projects) |\n| `AP_SHOW_EXEC_TIME` | `1` | Show command execution timing |\n| `AP_EXEC_TIME_THRESHOLD` | `2` | Minimum duration (s) to show timing |\n| `AP_SHOW_EXIT_CODE` | `1` | Show non-zero exit codes |\n| `AP_SHOW_TIME` | `1` | Show the right-side clock |\n| `AP_DIR_DEPTH` | `3` | Number of directory segments to show |\n\n\n## Troubleshooting\n\n\u003e [!IMPORTANT]\n\u003e **Icons appearing as squares?**\n\u003e 1. Ensure you are using a [Nerd Font](https://www.nerdfonts.com) (we recommend **JetBrainsMono**).\n\u003e 2. Check your locale: Run `locale` and ensure `LANG` includes `UTF-8`.\n\u003e 3. If you cannot use Nerd Fonts, set `AP_ASCII_FALLBACK=1` in your `.zshrc`.\n\n\n## License\nMIT © **Ahmed Mardi (fr3on)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffr3on%2Faporia","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffr3on%2Faporia","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffr3on%2Faporia/lists"}