{"id":21333794,"url":"https://github.com/rostrovsky/na","last_synced_at":"2026-04-06T08:01:30.523Z","repository":{"id":204398115,"uuid":"704414908","full_name":"rostrovsky/na","owner":"rostrovsky","description":"Nested aliases for your shell","archived":false,"fork":false,"pushed_at":"2023-10-31T20:45:45.000Z","size":5894,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-21T18:40:01.851Z","etag":null,"topics":["aliases","bash","command-line","commandline-tool","fish","fish-shell","na","nested","nested-alias","nested-aliases","powershell","shell","sodium","terminal-based","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/rostrovsky.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}},"created_at":"2023-10-13T07:57:52.000Z","updated_at":"2023-11-01T08:24:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"f0e87618-344c-4e1f-8774-1caa604f4b31","html_url":"https://github.com/rostrovsky/na","commit_stats":{"total_commits":40,"total_committers":2,"mean_commits":20.0,"dds":"0.050000000000000044","last_synced_commit":"7713655f4db23b43a0595a3d01acd57cf7b1bbce"},"previous_names":["rostrovsky/sodium","rostrovsky/na"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/rostrovsky/na","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rostrovsky%2Fna","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rostrovsky%2Fna/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rostrovsky%2Fna/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rostrovsky%2Fna/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rostrovsky","download_url":"https://codeload.github.com/rostrovsky/na/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rostrovsky%2Fna/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31464102,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"online","status_checked_at":"2026-04-06T02:00:07.287Z","response_time":112,"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":["aliases","bash","command-line","commandline-tool","fish","fish-shell","na","nested","nested-alias","nested-aliases","powershell","shell","sodium","terminal-based","zsh"],"created_at":"2024-11-21T23:16:15.222Z","updated_at":"2026-04-06T08:01:30.507Z","avatar_url":"https://github.com/rostrovsky.png","language":"Go","readme":"# sodium\n\n\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./na.png\" alt=\"Sodium\"\u003e\n\u003c/p\u003e\n\n**N**ested **a**liases for your shell.\n\n## Quick start\n\n1. Install `na`\n\n    ```shell\n    go install github.com/rostrovsky/na@latest\n    ```\n\n    ...or download binary from the [releases page](./releases) and put it somewhere in your `$PATH`.\n\n1. Set up your aliases in [config file](#config-file).\n1. Generate autocompletions for your shell:\n\n    * bash\n\n        ```shell\n        source \u003c(na completion bash)\n        ```\n\n    * zsh\n\n        ```shell\n        source \u003c(na completion zsh)\n        ```\n\n    * powershell\n\n        ```shell\n        Register-ArgumentCompleter -CommandName na -ScriptBlock $__naCompleterBlock\n        na completion powershell | Out-String | Invoke-Expression\n        ```\n\n    * fish\n\n        ```shell\n        na completion fish | source\n        ```\n\n1. Use it!\n\n    ```shell\n    na # and then press Tab ↹ as many times as you need\n    ```\n\n## Config file\n\n### Config file schema\n\n#### Minimal form\n\n```yaml\n# minimal form config example\naliases:\n  ssh:\n    dev:\n      host-x: ssh user@host-x\n      host-y: ssh user@host-y\n    prod:\n      host-a: ssh user@host-a\n      host-b: ssh user@host-b\n  grep:\n    heron: grep -hEron --with-filename --color=always\n```\n\n#### Full form\n\nCompared to the minimal form, in the full form:\n\n* you must add mandatory `_cmd` key which contains aliased command\n* you can add optional `_info` key that enriches autocompletion hints with description.\n\n```yaml\n# full form config example\naliases:\n  ssh:\n    _info: aliases for SSH connections\n    dev:\n      _info: DEV environments aliases\n      host-x:\n        _info: makes ssh connection to host X on DEV env\n        _cmd: ssh user@host-x\n      host-y:\n        _info: makes ssh connection to host Y on DEV env\n        _cmd: ssh user@host-y\n    prod:\n      _info: PROD environments aliases\n      host-a:\n        _info: makes ssh connection to host A on PROD env\n        _cmd: ssh user@host-a\n      host-b:\n        _info: makes ssh connection to host B on PROD env\n        _cmd: ssh user@host-b\n  grep: # _info key is completely optional though recommended\n    heron:\n      _cmd: grep -hEron --with-filename --color=always\n```\n\n### Config file location\n\nBy default, `na` expects configuration file placed in `~/.config/sodium/.narc.yaml` (or `.yml`).\n\nYou can override default config file location by setting `SODIUM_CONFIG` environment variable.\n\n## Supported shells\n\n`na` supports all [cobra](https://github.com/spf13/cobra)-generated autocompletions:\n\n* bash\n* fish\n* powershell\n* zsh\n\n## Reserved aliases\n\nBelow aliases cannot be used due to being [cobra](https://github.com/spf13/cobra) bultins:\n\n* `completion`\n* `help`\n* `--help`\n* `-h`\n* any alias starting with underscore `_`\n\n## Debug logs\n\nIf you need to see the debug logs, set `SODIUM_LOG_LEVEL` env variable to `debug` (case insensitive).\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frostrovsky%2Fna","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frostrovsky%2Fna","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frostrovsky%2Fna/lists"}