{"id":37355718,"url":"https://github.com/tim-smart/lalph","last_synced_at":"2026-04-01T16:34:38.219Z","repository":{"id":332219978,"uuid":"1133083661","full_name":"tim-smart/lalph","owner":"tim-smart","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-29T20:59:29.000Z","size":6221,"stargazers_count":105,"open_issues_count":1,"forks_count":12,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-03-29T22:14:49.576Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/tim-smart.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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":"AGENTS.md","dco":null,"cla":null},"funding":{"github":["tim-smart"]}},"created_at":"2026-01-12T21:27:07.000Z","updated_at":"2026-03-29T20:58:49.000Z","dependencies_parsed_at":"2026-03-13T00:00:54.051Z","dependency_job_id":null,"html_url":"https://github.com/tim-smart/lalph","commit_stats":null,"previous_names":["tim-smart/lalph"],"tags_count":254,"template":false,"template_full_name":null,"purl":"pkg:github/tim-smart/lalph","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-smart%2Flalph","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-smart%2Flalph/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-smart%2Flalph/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-smart%2Flalph/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tim-smart","download_url":"https://codeload.github.com/tim-smart/lalph/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-smart%2Flalph/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290531,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":[],"created_at":"2026-01-16T04:30:38.212Z","updated_at":"2026-04-01T16:34:38.193Z","avatar_url":"https://github.com/tim-smart.png","language":"TypeScript","funding_links":["https://github.com/sponsors/tim-smart"],"categories":["Parallel Agent Runners"],"sub_categories":[],"readme":"```\n  .--.\n |^()^|  lalph\n  '--'\n```\n\nA LLM agent orchestrator driven by your chosen source of issues.\n\n## Features\n\n- Pull work from an issue source (GitHub Issues, Linear, etc.) and keep task state in sync\n- Projects to group execution settings (enabled state, concurrency, target branch, git flow, review agent)\n- Agent presets to control which CLI agent and optional clanka model run tasks, with optional label-based routing\n- Plan mode to turn a high-level plan into a spec and generate PRD tasks\n- Git worktrees to support multiple concurrent iterations\n- Optional PR flow with auto-merge and support for issue dependencies\n\n## Installation\n\n```bash\nnpm install -g lalph\n```\n\nor run with npx:\n\n```bash\nnpx -y lalph@latest\n```\n\n## CLI usage\n\n- Run the main loop across enabled projects: `lalph`\n- Run a bounded set of iterations per enabled project: `lalph --iterations 1`\n- Configure projects and per-project concurrency: `lalph projects add`\n- Inspect and configure agent presets: `lalph agents ls`\n- Start plan mode: `lalph plan`\n- Create an issue from your editor: `lalph issue`\n- Choose your issue source integration (applies to all projects): `lalph source`\n\nIt is recommended to add `.lalph/` to your `.gitignore` to avoid committing your\ncredentials.\n\n## Agent presets\n\nAgent presets define which CLI agent runs tasks, the optional clanka model to\nuse, and any extra arguments. Lalph always needs a default preset and will\nprompt you to create one on first run if it's missing.\n\nSome issue sources support routing: you can associate a preset with a label, and\nissues with that label will run with that preset; anything else uses the default.\n\n```bash\nlalph agents ls\nlalph agents add\n```\n\n`lalph agents ls` shows each preset's CLI agent, clanka model selection,\nextra args, command prefix, and any issue-source routing metadata.\n\n## Projects\n\nProjects bundle execution settings for the current repo: whether it is enabled\nfor runs, how many tasks can run concurrently, which branch to target, what git\nflow to use, and whether review is enabled.\n\n`lalph` runs across all enabled projects in parallel; for single-project\ncommands, you'll be prompted to choose an active project when needed.\n\n```bash\nlalph projects add\nlalph projects toggle\n```\n\n## Plan mode\n\nPlan mode opens an editor so you can write a high-level plan. You can also pass\n`--file` / `-f` with a markdown file path to skip the editor. On save (or file\nread), lalph generates a specification under `--specs` and then creates PRD\ntasks from it.\n\nUse `--dangerous` to skip permission prompts during spec generation, and `--new`\nto create a project before starting plan mode.\nIf you have multiple agent presets, plan commands prompt you to choose which\npreset to run before launching the CLI agent.\n\n```bash\nlalph plan\nlalph plan --file ./my-plan.md\nlalph plan tasks .specs/my-spec.md\n```\n\n## Creating issues\n\n`lalph issue` opens a new-issue template in your editor. When you save and close\nthe file, the issue is created in the current issue source.\n\nAnything below the front matter is used as the issue description.\n\nFront matter fields:\n\n- `title`: short issue title\n- `priority`: number (0 = none, 1 = urgent, 2 = high, 3 = normal, 4 = low)\n- `estimate`: number of points, or `null`\n- `blockedBy`: array of issue identifiers\n- `autoMerge`: whether to mark this issue for auto-merge when applicable\n\n```bash\nlalph issue\nlalph i\n```\n\n## Development\n\n- Install dependencies: `pnpm install`\n- Build the CLI: `pnpm build`\n- Run validations: `pnpm check`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftim-smart%2Flalph","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftim-smart%2Flalph","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftim-smart%2Flalph/lists"}