{"id":22685917,"url":"https://github.com/sverrirab/envirou","last_synced_at":"2026-04-07T14:03:10.875Z","repository":{"id":50953487,"uuid":"85482196","full_name":"sverrirab/envirou","owner":"sverrirab","description":"Manage your shell environment with Envirou","archived":false,"fork":false,"pushed_at":"2024-03-09T11:07:41.000Z","size":3582,"stargazers_count":7,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-26T13:53:59.810Z","etag":null,"topics":["bash","cmd","env","profile","shell","zsh"],"latest_commit_sha":null,"homepage":"","language":"Go","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/sverrirab.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2017-03-19T14:26:08.000Z","updated_at":"2023-02-08T16:01:24.000Z","dependencies_parsed_at":"2024-06-19T19:06:44.738Z","dependency_job_id":"a7af4d36-b717-45fa-903a-6bd554198186","html_url":"https://github.com/sverrirab/envirou","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sverrirab%2Fenvirou","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sverrirab%2Fenvirou/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sverrirab%2Fenvirou/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sverrirab%2Fenvirou/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sverrirab","download_url":"https://codeload.github.com/sverrirab/envirou/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248623419,"owners_count":21135247,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bash","cmd","env","profile","shell","zsh"],"created_at":"2024-12-09T22:18:32.098Z","updated_at":"2025-04-12T19:36:25.660Z","avatar_url":"https://github.com/sverrirab.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# envirou - View and manage your shell environment\n\n[![build](https://github.com/sverrirab/envirou/actions/workflows/build.yml/badge.svg)](https://github.com/sverrirab/envirou/actions/workflows/build.yml)\n\nEnvirou (`ev`) helps you to quickly view and configure your shell \n environment. Display important variables with nice formatting and hide the ones you don't care about. No more custom shell scripts to configure your environment or guessing which one is active!\n \n\n![Simple View](./screenshots/header.png)\n\n\n# Key hightlights \n* Works with any other tool - just views and optionally sets environment variables.\n* Compact output (replaces $HOME with `~` and _underscores_ paths for readability).\n* Hides all irrelevant variables such as `TMPDIR`, `LSCOLORS` etc, etc.\n* Fully customizable.\n* Works on Mac + Linux (bash + zsh) and Windows (bat and PowerShell).  \n* Fully standalone go binary.\n* Command completion support (bash + zsh).\n* Includes [oh-my-zsh](https://ohmyz.sh/) theme and PowerShell prompt script.\n\n\n## Why?\nEveryone that works with complex infrastructure or multiple development environments from the command line know the feeling of using the wrong toolchain or environment and having the nagging suspicion that you have mixed something up in your configuration. Classical examples \nare PATH's to tools/SDK versions, external service endpoints for your PROD and DEV environments\netc etc.\n\n\n## Quickstart\n1. You will need to have [go installed](https://go.dev/) (go1.16 or newer) \n2. Install with `go install github.com/sverrirab/envirou@latest`\n3. Run `envirou` to view your current environment or `envirou --help` for more information\n\n## Full power of envirou\nFor the full power of envirou you will need to allow it to modify your environment (switch profiles).  \nThis will require it to run in the context of the current shell.\nPlease check out these documents for your shell:\n\n* [Bash (and zsh) instructions](./bash/README.md)\n* [PowerShell instructions](./powershell/README.md)\n\n## First time use\n\nOut of the box `ev` is useful but for \nAfter you start a new shell you should be able to run `ev -a` to list all env variables and \n`ev -help` will provide details of other commands.\n\nNext step is check out `ev -edit` and start modifying the configuration. Create your own groupings and profiles!\n\n## Example use cases\n### AWS configuration\nAdd all your aws profiles in `~/.aws/config`.  Then create an Envirou profile for each\nthat sets the `AWS_PROFILE` variable to the name of the AWS profile.  This way you can\neasily e.g. switch between `dev` and `prod` or even the default region or output formatting.\n\n### Kubectl configuration\nCopy your `~/.kube/config` into a new file for each environment.  Create an Envirou \nprofile for each that sets the `KUBECONFIG` pointing to each file.\n\nMake sure you set the default context in each file to be the correct one.  This way you\ncan create different profiles that for example have a different default namespace.\n\n## Example configuration\n\n```inifile\n[profile:basic]\nPATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Users/sab/src/custom/bin\nVIRTUAL_ENV\nAWS_PROFILE\n\n[profile:py3]\nPATH=/Users/sab/sdk/py3/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Users/sab/src/custom/bin\nVIRTUAL_ENV=/Users/sab/sdk/py3\n\n[profile:py2]\nPATH=/Users/sab/sdk/py2/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/Users/sab/src/custom/bin\nVIRTUAL_ENV=/Users/sab/sdk/py2\n\n[profile:awsprod]\nAWS_PROFILE=prod\n\n[profile:awsdev]\nAWS_PROFILE=dev\n```\n\n\n## Where does the name come from? \nThe name Envirou is inspired by Spirou the comic book character.  \nThe alias `ev` is both short for *Envirou* and `env`. \n\n\n## But where is the python code?\n\nThe last version using python was [versions v4.4](https://github.com/sverrirab/envirou/releases/tag/v4.4)\n\n## License\n\nFree for any use see [MIT License](./LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsverrirab%2Fenvirou","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsverrirab%2Fenvirou","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsverrirab%2Fenvirou/lists"}