{"id":13522035,"url":"https://github.com/hashicorp/damon","last_synced_at":"2025-04-05T07:05:16.007Z","repository":{"id":37375931,"uuid":"388589713","full_name":"hashicorp/damon","owner":"hashicorp","description":"A terminal UI (TUI) for HashiCorp Nomad","archived":false,"fork":false,"pushed_at":"2023-11-02T10:47:23.000Z","size":251,"stargazers_count":443,"open_issues_count":6,"forks_count":19,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-03-29T06:06:32.298Z","etag":null,"topics":["golang","hashicorp","nomad","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hashicorp.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-22T20:31:54.000Z","updated_at":"2025-03-25T07:17:43.000Z","dependencies_parsed_at":"2023-11-02T11:34:27.235Z","dependency_job_id":null,"html_url":"https://github.com/hashicorp/damon","commit_stats":{"total_commits":61,"total_committers":13,"mean_commits":"4.6923076923076925","dds":0.5245901639344263,"last_synced_commit":"779a540056210e5f5ae28377a9523959b89a86a2"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fdamon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fdamon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fdamon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hashicorp%2Fdamon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hashicorp","download_url":"https://codeload.github.com/hashicorp/damon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247299832,"owners_count":20916190,"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":["golang","hashicorp","nomad","tui"],"created_at":"2024-08-01T06:00:41.257Z","updated_at":"2025-04-05T07:05:15.987Z","avatar_url":"https://github.com/hashicorp.png","language":"Go","funding_links":[],"categories":["Go","\u003ca name=\"system\"\u003e\u003c/a\u003eSystem tools","Table of Contents","Infrastructure setup","User interfaces"],"sub_categories":["User Interfaces and Dashboards"],"readme":"# Damon - A terminal Dashboard for HashiCorp Nomad\n\nDamon is a terminal user interface (TUI) for Nomad. It provides functionality to observe and interact with Nomad resources such as Jobs, Deployments, or Allocations. Interactions include:\n\n- View Jobs and Job allocations\n- View Deployments\n- View Namespaces\n- Show Task events\n- Show Job status/information (equally to `$ nomad status \u003cjob\u003e`)\n- Show Logs in an active log stream (including filtering + highlighting).\n- and more...\n\n**Additional Notes**\n\nDamon is in an early stage and is under active development. We are working on improving the performance and adding new features to Damon.\nPlease take a look at the Damon [project board](https://github.com/hashicorp/damon/projects/2) to see what features you can expect in near future.\nIf you find a bug or you have great ideas how Damon can be improved feel free to open an issue. To avoid duplicates, please check the [project board](https://github.com/hashicorp/damon/projects/2) \nbefore submitting one. Thank you!\n\n## Screenshot\n\n![image](https://user-images.githubusercontent.com/82210389/126840047-dd96be77-f7fc-4903-972a-c783cc615a33.png)\n\n\n## Installation\n\n### Brew\n\n--\u003e Coming soon\n\n### Building from source and Run Damon\n\nMake sure you have your go environment setup:\n\n1. Clone the project\n1. Run `$ make build` to build the binary\n1. Run `$ make run` to run the binary\n1. You can use `$ make install-osx` on a Mac to cp the binary to `/usr/local/bin/damon`\n\nor\n\n```\n$ go install ./cmd/damon\n```\n\n### How to use it\n\nOnce `Damon` is installed and avialable in your path, simply run:\n\n```\n$ damon\n```\n\n#### Environment Variables\n\nDamon reads the following environment variables on startup:\n\n- `NOMAD_TOKEN`\n- `NOMAD_ADDR`\n- `NOMAD_REGION`\n- `NOMAD_NAMESPACE`\n- `NOMAD_HTTP_AUTH`\n- `NOMAD_CACERT`\n- `NOMAD_CAPATH`\n- `NOMAD_CLIENT_CERT`\n- `NOMAD_CLIENT_KEY`\n- `NOMAD_TLS_SERVER_NAME`\n- `NOMAD_SKIP_VERIFY`\n\nYou can read about them in detail [here](https://www.nomadproject.io/docs/runtime/environment).\n\n## Navigation\n\n### General\n\nOn every table or text view, you can use:\n\n- `k` or `arrow up` to navigate up\n- `j` or `arrow down` to navigate down\n\n### Top Level Commands\n\n- Show Jobs: `ctrl-j`\n- Show Deployments: `ctrl-d`\n- Show Namespaces: `ctrl-n`\n- Jump to a Jobs Allocations: `ctrl-j`\n- Switch Namespace: `s`\n- Quit: `ctrl-c`\n\n### Job View Commands\n\n- Show Allocations for a Job: `\u003cENTER\u003e` (on the selected job)\n- Show TaskGroups for a Job: `\u003ct\u003e` (on the selected job)\n- Show information for a Job: `\u003ci\u003e` (on the selected job)\n- Filter Job: `\u003c/\u003e` (on the selected job)\n- Show Job Info: `i` (on the selected job)\n\n### Task View Commands\n\n- Show logs on `STDOUT` for a Task: `\u003cENTER\u003e`\n- Show logs on `STDERR` for a Task: `\u003cctrl-e\u003e`\n- Show events for a Task: `\u003ce\u003e`\n\n\n### Log View\n\nWhen Damon displays logs, you can navigate through the logs using `j`, `k`, `G`, and `g`.\n\n- To filter logs you can hit `/` which will open an input field to enter the filter string.\n- To highligh logs you can hit `h`. This will also open an input field to enter the highlighting string.\n- Hit `s` to stop a log stream.\n- Hit `r` to resume a log stream.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fdamon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhashicorp%2Fdamon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhashicorp%2Fdamon/lists"}