{"id":50808960,"url":"https://github.com/bethropolis/bgrun","last_synced_at":"2026-06-13T03:11:05.444Z","repository":{"id":361661265,"uuid":"1255293418","full_name":"bethropolis/bgrun","owner":"bethropolis","description":"yet another background process runner. daemon-managed, auto-shutdown, PTY attach, wait-for-pattern, memory guardrails","archived":false,"fork":false,"pushed_at":"2026-06-13T00:47:20.000Z","size":188,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-13T01:10:08.577Z","etag":null,"topics":["ai-agents","background-jobs","cli","daemon","process-manager","rust"],"latest_commit_sha":null,"homepage":"https://bethropolis.github.io/bgrun/","language":"Rust","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/bethropolis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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-05-31T16:46:21.000Z","updated_at":"2026-06-13T00:47:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/bethropolis/bgrun","commit_stats":null,"previous_names":["bethropolis/bgrun"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/bethropolis/bgrun","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bethropolis%2Fbgrun","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bethropolis%2Fbgrun/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bethropolis%2Fbgrun/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bethropolis%2Fbgrun/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bethropolis","download_url":"https://codeload.github.com/bethropolis/bgrun/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bethropolis%2Fbgrun/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34270483,"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-13T02:00:06.617Z","response_time":62,"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":["ai-agents","background-jobs","cli","daemon","process-manager","rust"],"created_at":"2026-06-13T03:11:04.877Z","updated_at":"2026-06-13T03:11:05.437Z","avatar_url":"https://github.com/bethropolis.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bgrun\n\n[![CI](https://github.com/bethropolis/bgrun/actions/workflows/release.yml/badge.svg)](https://github.com/bethropolis/bgrun/actions/workflows/release.yml)\n[![License: MIT](https://img.shields.io/github/license/bethropolis/bgrun)](LICENSE)\n\nA background process runner for AI agents and automation workflows. Start processes, check status, tail logs, and kill them over a Unix socket with JSON output. The daemon auto-starts on first CLI use.\n\n## Install\n\n### Quick install (Linux)\n\n```bash\ncurl -fsSL https://bethropolis.github.io/bgrun/install.sh | sh\n```\n\nDownloads the latest prebuilt binary from GitHub releases.\n\n### AUR (Arch Linux)\n\n```\nyay -S bgrun-bin\n```\n\n### Homebrew (Linux)\n\n```bash\nbrew tap bethropolis/tap\nbrew install --cask bethropolis/tap/bgrun\n```\n\n### From source (Linux)\n\n```bash\n./install.sh\n```\n\nRequires the Rust toolchain (`cargo`). This builds from a local clone and installs\n`bgrun` (CLI) and `bgrun-daemon` (auto-started by the CLI) to `~/.local/bin`.\n\nOptional: install the OpenCode skill bundle from `docs/bgrun/`:\n\n```bash\n./install.sh --install-skill\n```\n\n## Quick start\n\n```bash\nbgrun run --name server --ready-when \"listening on\" cargo run\n# → {\"id\":\"abc123\",\"name\":\"server\",\"state\":\"running\",...}\n\nbgrun wait abc123 --timeout 30s\n\nbgrun tail abc123 --digest\n# → {\"total_lines\":82,\"errors\":0,\"warnings\":2,...}\n\nbgrun kill abc123\n```\n\n## Commands\n\n| Command | Purpose |\n|---------|---------|\n| `bgrun run [flags] \u003ccmd...\u003e` | Start a background process |\n| `bgrun run-group \u003cname\u003e \u003cname\u003e ...` | Start multiple named jobs in parallel |\n| `bgrun list [--workspace \u003cws\u003e]` | List all jobs |\n| `bgrun status \u003cid\u003e` | Get job state |\n| `bgrun wait \u003cid\u003e --timeout \u003cd\u003e` | Block until ready or timeout |\n| `bgrun tail \u003cid\u003e [--digest] [--level \u003cl\u003e]` | Show logs |\n| `bgrun diff \u003cid\u003e` | Show new log lines since last call |\n| `bgrun send \u003cid\u003e \u003cdata\u003e` | Write to stdin |\n| `bgrun stats \u003cid\u003e` | Show CPU/RSS/uptime |\n| `bgrun kill \u003cid\u003e [--workspace \u003cws\u003e]` | Terminate job(s) |\n| `bgrun attach \u003cid\u003e` | Attach to a PTY job interactively |\n| `bgrun expect \u003cid\u003e \u003cpattern\u003e` | Wait for a log line matching pattern |\n| `bgrun stats \u003cid\u003e` | Show CPU/RSS/uptime |\n| `bgrun schema \u003ccommand\u003e` | Print JSON Schema for a command's args |\n| `bgrun skill install \u003cdir\u003e` | Install embedded skill bundle |\n| `bgrun` (no args) | Open interactive TUI menu |\n\n## Docs\n\n- [Command Reference](docs/commands.md) — flags, examples, output shapes\n- [bgrun.toml](docs/bgrun-toml.md) — named job definitions and dependencies\n- [Architecture](docs/architecture.md) — daemon, protocol, readiness system\n\n## Crate layout\n\nWorkspace crates:\n\n| Crate | Role |\n|-------|------|\n| `bgrun-proto` | Shared types, no I/O |\n| `bgrun-core` | Job state machine, config parser, no I/O |\n| `bgrun-daemon` | Spawns/monitors/kills processes, serves the CLI |\n| `bgrun-cli` | User-facing CLI |\n\nCLI and daemon communicate over a Unix socket with NDJSON. The daemon stores state in `~/.local/share/bgrun/`.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbethropolis%2Fbgrun","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbethropolis%2Fbgrun","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbethropolis%2Fbgrun/lists"}