{"id":51298862,"url":"https://github.com/a-chacon/procman","last_synced_at":"2026-06-30T17:02:48.321Z","repository":{"id":366641545,"uuid":"1277277944","full_name":"a-chacon/procman","owner":"a-chacon","description":"Process manager for Procfile-based applications","archived":false,"fork":false,"pushed_at":"2026-06-23T14:22:17.000Z","size":1698,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-23T16:12:09.117Z","etag":null,"topics":["cli","procfile","tui"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a-chacon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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-06-22T18:44:17.000Z","updated_at":"2026-06-23T14:23:05.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/a-chacon/procman","commit_stats":null,"previous_names":["a-chacon/proctui","a-chacon/procman"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/a-chacon/procman","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-chacon%2Fprocman","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-chacon%2Fprocman/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-chacon%2Fprocman/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-chacon%2Fprocman/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a-chacon","download_url":"https://codeload.github.com/a-chacon/procman/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-chacon%2Fprocman/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34975672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-30T02:00:05.919Z","response_time":92,"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":["cli","procfile","tui"],"created_at":"2026-06-30T17:02:47.688Z","updated_at":"2026-06-30T17:02:48.309Z","avatar_url":"https://github.com/a-chacon.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Procman\n\nA terminal user interface (TUI) for managing Procfile-based applications. `procman` allows you to monitor, search, and interact with multiple processes simultaneously in a single dashboard.\n\n## Captures\n\n### Grid\n\n![procman grid mode](docs/images/grid.png)\n\n### Fullscreen\n\n![procman fullscreen process](docs/images/fullscreen.png)\n\n### Interactive\n\n![procman interactive mode](docs/images/interactive.png)\n\n## Features\n\n- **Procfile Support**: Automatically loads and manages processes defined in your `Procfile`.\n- **Interactive Terminal**: Full VT100 terminal emulation for interacting with processes (perfect for debuggers like `gdb` or `lldb`).\n- **Log Management**:\n  - Real-time log streaming with ANSI color support.\n  - Search through logs with highlighting.\n  - Filter logs to focus on specific output.\n- **Process Control**: Start, stop, and restart individual processes with single keybindings.\n- **Flexible Layout**: Toggle between a grid view of all processes and a fullscreen view for deep dives.\n\n## Installation\n\nFor now, you can install `procman` via [Cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html):\n\n```bash\ncargo install proc-man\n```\n\nOr with the official script (Linux and MacOS for the momment):\n\n```\ncurl --proto '=https' --tlsv1.2 -LsSf https://github.com/a-chacon/procman/releases/latest/download/proc-man-installer.sh | sh\n```\n\n## Quick Start\n\n1. Ensure you have a `Procfile` in your project root.\n2. Run `procman`:\n\n   ```bash\n   procman\n   ```\n\n   Or specify a custom path to your `Procfile`:\n\n   ```bash\n   procman ./path/to/my/Procfile\n\n   ```\n\n## For Rails Apps\n\nTo use `procman` as a drop-in replacement for Foreman in your Rails application, replace the contents of your `bin/dev` script with the following. This script automatically checks if `procman` is installed and installs it via the official installer if missing:\n\n```bash\n#!/usr/bin/env sh\n\n# Check if procman is installed; if not, install it automatically\nif ! command -v procman \u003e/dev/null 2\u003e\u00261; then\n  echo \"procman not found. Installing...\"\n  curl --proto '=https' --tlsv1.2 -LsSf https://github.com/a-chacon/procman/releases/latest/download/proc-man-installer.sh | sh\n  \n  # Refresh shell path if needed (depending on shell and install location)\nfi\n\n# Default to port 3000 if not specified\nexport PORT=\"${PORT:-3000}\"\n\n# Start processes via procman\nexec procman Procfile.dev \"$@\"\n```\n\n## Usage\n\n`procman` is designed to be intuitive and fast. Inspired by tools like `btop`, you can perform actions by simply pressing the **bolded** letter displayed in each label on the screen.\n\n- **i**nteractive: Enter interactive mode to talk to the process (e.g., a debugger). Press `Ctrl-A` to exit.\n- **f**ullscreen / **Enter**: Expand the selected process to fill the screen.\n- se**a**rch: Find and highlight specific text in the logs.\n- filte**r**: Hide lines that don't match your criteria.\n- star**t**: Start a stopped process.\n- **s**top: Terminate a running process.\n- r**e**start: Quickly stop and start the process.\n- **q** / **Ctrl-C**: Exit `procman`.\n\nNavigation is handled via **arrow keys** or **hjkl**. You can also jump directly to a process by pressing its corresponding number **1-9**.\n\n## License\n\nThis project is licensed under the [GNU General Public License v3.0](LICENSE).\n\nBy using this software, you agree to the terms outlined in the license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-chacon%2Fprocman","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa-chacon%2Fprocman","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-chacon%2Fprocman/lists"}