{"id":15402417,"url":"https://github.com/pirj/toreman","last_synced_at":"2025-06-24T06:04:08.794Z","repository":{"id":66314181,"uuid":"187113107","full_name":"pirj/toreman","owner":"pirj","description":"Manage Procfile-based applications","archived":false,"fork":false,"pushed_at":"2020-06-03T00:26:43.000Z","size":174,"stargazers_count":19,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-16T02:53:46.544Z","etag":null,"topics":["foreman","process-manager","procfile"],"latest_commit_sha":null,"homepage":"https://github.com/pirj/toreman","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/pirj.png","metadata":{"files":{"readme":"README.adoc","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":"2019-05-16T23:11:45.000Z","updated_at":"2024-07-24T21:50:27.000Z","dependencies_parsed_at":"2023-06-26T07:16:15.578Z","dependency_job_id":null,"html_url":"https://github.com/pirj/toreman","commit_stats":{"total_commits":7,"total_committers":1,"mean_commits":7.0,"dds":0.0,"last_synced_commit":"1a201a3f2fb325c172279f481fd3e5cc103c239d"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/pirj/toreman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirj%2Ftoreman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirj%2Ftoreman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirj%2Ftoreman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirj%2Ftoreman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pirj","download_url":"https://codeload.github.com/pirj/toreman/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pirj%2Ftoreman/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261618059,"owners_count":23185090,"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":["foreman","process-manager","procfile"],"created_at":"2024-10-01T16:03:09.492Z","updated_at":"2025-06-24T06:04:08.759Z","avatar_url":"https://github.com/pirj.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"= Toreman\n\nToreman is a one'ish-line shell script https://github.com/ddollar/foreman[foreman] clone that is running processes in separate https://github.com/tmux/tmux[tmux] panes.\n\nWith tmux, interleaved output, and interactive debugging are not a problem anymore.\n\nIt's also possible to selectively stop/restart processes.\n\nimage::tiled.png[]\n\n== Usage\n\nIn a running tmux session, from a directory containing `Procfile`, run `toreman`.\nIt will parse your `Procfile` and run each entry in a separate split.\n\nUse C-b h/j to navigate between panes, and C-b z to toggle full-screen zoom.\n\nIt's possible to specify a layout as a first argument to `toreman`, e.g.\n\n[source,shell]\n----\ntoreman even-vertical\n----\n\nimage::even-vertical.png[]\n\nAvailable layouts are: `even-horizontal`, `even-vertical`, `main-horizontal`, `main-vertical`, `tiled` (default).\n\n== Installation\n\nIf you're on macOS and are using https://brew.sh/[Homebrew], it's as easy as:\n\n[source,shell]\n----\nbrew install pirj/homebrew-toreman/toreman\n----\n\nOtherwise, drop the `toreman` binary somewhere on your `$PATH`, or add an alias in your `rc` file:\n\n[source,shell]\n----\nalias toreman=\"grep --invert-match '#' \u003c Procfile | sed -e 's/^[^:]*: //' | xargs -I {} tmux split-window -v \\; send-keys '[ -s .env ] \u0026\u0026 source .env; {}' 'C-m' \u0026\u0026 tmux select-pane -t 1 \\; send-keys 'C-d' \\; select-layout ${1:-tiled}\"\n----\n\n== Alternatives\n\nCheck out https://github.com/DarthSim/overmind[overmind] if you prefer 1600 lines of Go over one line of shell script, or other https://github.com/ddollar/foreman#ports[Foreman ports].\n\n== Resources\n\nhttps://fili.pp.ru/oneline-procfile-manager.html[Blog post].\n\nhttps://www.reddit.com/r/ruby/comments/bpka4m/toreman_a_oneline_foreman_port_for_use_with_tmux/[Reddit thread].\n\n== Author\n\nhttps://fili.pp.ru[Phil Pirozhkov], software developer in law.\n\n== License\n\nToreman is licensed under MIT License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirj%2Ftoreman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpirj%2Ftoreman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpirj%2Ftoreman/lists"}