{"id":50371981,"url":"https://github.com/tim-projects/hammer","last_synced_at":"2026-05-30T07:30:56.134Z","repository":{"id":346951701,"uuid":"1173707989","full_name":"tim-projects/hammer","owner":"tim-projects","description":"Use BRUTE FORCE to ship code using light LLM models with AI-powered git-backed project management: state machines, quality gates, audit trails, Jira replacement - all in your repo","archived":false,"fork":false,"pushed_at":"2026-05-23T18:22:05.000Z","size":8877,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T19:17:28.793Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tim-projects.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-05T17:00:10.000Z","updated_at":"2026-05-20T09:10:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tim-projects/hammer","commit_stats":null,"previous_names":["tim-projects/tasks-ai","tim-projects/hammer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tim-projects/hammer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Fhammer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Fhammer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Fhammer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Fhammer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tim-projects","download_url":"https://codeload.github.com/tim-projects/hammer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tim-projects%2Fhammer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33684413,"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-05-30T02:00:06.278Z","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":[],"created_at":"2026-05-30T07:30:56.057Z","updated_at":"2026-05-30T07:30:56.124Z","avatar_url":"https://github.com/tim-projects.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **HAMMER IS BOSS.** LLM SUBMIT. POUND weak code through quality gates to DONE! **CODE QUALITY 10X!**\n\n\u003cimg src=\"hammer-icon.webp\" width=\"300\"/\u003e\n\nYour lite/small local or cloud LLM writes code. Without HAMMER you get toy prototypes that break in production. HAMMER blocks weak code with test and lint gates, forces complete specs, and tracks every change in git.\n\nAgents can't skip steps. Result: shippable code that doesn't explode in production.\n\n**Zero deps. Git-powered. One-line install.**\n\n## Ship BETTER and CHEAPER with HAMMER: AI-Powered Git-Backed Project Management 🔨⚔️\n\n`tasks` = complete system IN your repo.  \nState machines + quality gates + audit trails + git worktrees.  \n**Built for AI agents.**\n\n## 🚀 One-Line Install\n\n**HAMMER SMASH INSTALL!**\n```bash\ncurl -sSL https://raw.githubusercontent.com/tim-projects/hammer/main/install.sh | bash\n```\nInstalls `hammer` to `~/.local/bin/hammer`. No sudo.\n\n**Global HAMMER:**\n```bash\ncurl -sSL https://raw.githubusercontent.com/tim-projects/hammer/main/install.sh | sudo bash -s -- --system\n```\n\n**Note:** After installation, if `hammer` commands are not found, run `hash -r` to refresh your shell's command cache, or open a new terminal window. This ensures the shell recognizes the newly created symlinks.\n\n## 🛠️ Getting Started\n\nAdd this to the top of your AGENTS.md:\n\n```\nDirective: \"Manage project tasks using the tasks command. Run hammer tasks -h to discover the interface and operational protocol.\"\n```\n\nAgent autonomously runs:\n1. `hammer tasks init` - Initialize system\n2. `hammer tasks list` / `hammer tasks create` - Discover/create tasks\n3. `hammer tasks move` - Move through Git-native state machine\n\n## 🔨 HAMMER STATE MACHINE\n\n```\nBACKLOG → READY → PROGRESSING → TESTING → REVIEW → STAGING → DONE → ARCHIVED\n                                       ↓                    ↓\n                                  REJECTED              REJECTED\n```\n\n**HAMMER GATES BLOCK WEAK CODE:**\n| Gate | Requirement |\n|------|-------------|\n| PROGRESSING | Complete story/tech/plan |\n| TESTING | `hammer check all` PASSES |\n| REVIEW | Tests pass + branch pushed + diff generated |\n| STAGING | Regression check passed (Rc flag) |\n| DONE | Merged to main |\n| ARCHIVED | Merged to main + regression check passed |\n\n## 💥 HAMMER vs Chaos\n\n| Without HAMMER | With HAMMER |\n|----------------|-------------|\n| Scattered notes | **HAMMER AUDIT!** Git log every smash |\n| Manual updates | **HAMMER STATE MACHINE!** Gates block weak code |\n| Lost context | **HAMMER HISTORY FULL!** Every change tracked |\n| \"What's ready?\" | **HAMMER PIPELINE CLEAR!** Testing → Live order |\n| Agent chaos | **HAMMER ATOMIC ID!** Blockers + branch lock |\n\n## 🛠️ HAMMER COMMANDS\n\n### Task Management\n```bash\nhammer tasks init                    # HAMMER BUILD SYSTEM!\nhammer tasks list                     # SHOW ALL!\nhammer tasks create \"SMASH BUG\"       # NEW METAL!\nhammer tasks show 42                  # METAL DETAIL!\nhammer tasks current                  # ACTIVE METAL!\n```\n\n### POUND THROUGH GATES\n```bash\nhammer tasks move 42 PROGRESSING     # START SMASH! (Creates branch)\nhammer tasks move 42 TESTING         # ✅ HAMMER LIKE! MOVE → TESTING ⚔️🔨\nhammer tasks move 42 DONE            # 🔨 HAMMER SMASH GOOD! DONE! ⚔️🔨\n```\n\n### QUALITY SMASH\n```bash\nhammer check all                     # SMASH ALL CHECKS!\nhammer check lint --fix              # FIX WEAK CODE!\nhammer tasks run all                 # HAMMER VALIDATE EVERYTHING!\n```\n\n## 🎯 REAL HAMMER FLOW\n\n```bash\nhammer tasks init                    # ✅ HAMMER LIKE! SYSTEM READY! ⚔️🔨\nhammer tasks create \"SMASH LOGIN\"    # NEW METAL 42!\nhammer tasks move 42 PROGRESSING     # BRANCH CREATE!\nhammer check all                     # ❌ TEST BREAK! HAMMER SAY NO! FIX! 🔨\n# LLM FIXES...\nhammer tasks move 42 TESTING         # ✅ HAMMER LIKE! MOVE → TESTING ⚔️🔨\nhammer tasks move 42 DONE            # 🔨 HAMMER SMASH GOOD! DONE! ⚔️🔨\n```\n\n## ⚙️ Task File (Git-Backed)\n\n```yaml\n***\nId: 42\nTi: Fix login bug\nSt: PROGRESSING\n***\n## Story\nUser cannot login with special characters in password.\n\n## Plan\n1. Fix regex validation\n2. Test unicode input\n3. Check error messages\n```\n\n## 🔧 HAMMER CONFIG\n```bash\nhammer tasks config detect           # HAMMER FIND TOOLS!\nhammer tasks config set repo.test pytest\n```\n\n## 🎉 Why HAMMER RULES?\n\n- **No external services** - Pure git\n- **Zero deps** - One-line install  \n- **Agent-optimized** - JSON output, clear protocol\n- **Enforced quality** - Gates BLOCK weak code\n- **Full lifecycle** - Backlog → DONE → ARCHIVED\n\n**HAMMER IS BOSS. WEAK LLM SUBMIT. STRONG TEAM SHIP!** 🔨⚔️\n```\n# Update\nFinal pipeline verification\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftim-projects%2Fhammer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftim-projects%2Fhammer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftim-projects%2Fhammer/lists"}