skillfullstack 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (775) hide show
  1. package/.skillsRegistry/catalog.json +231 -0
  2. package/AGENTS.md +89 -0
  3. package/README.md +210 -2
  4. package/bin/index.js +508 -0
  5. package/package.json +57 -4
  6. package/skills/backend/apiEngineering/SKILL.md +102 -0
  7. package/skills/backend/apiEngineering/evals/evalApiEngineering.py +81 -0
  8. package/skills/backend/apiEngineering/evals/fixtures/invalid/sampleInvalidOpenApi.json +40 -0
  9. package/skills/backend/apiEngineering/evals/fixtures/valid/sampleValidOpenApi.json +47 -0
  10. package/skills/backend/apiEngineering/policies/compatibility.md +42 -0
  11. package/skills/backend/apiEngineering/policies/mandatory.md +48 -0
  12. package/skills/backend/apiEngineering/policies/performance.md +39 -0
  13. package/skills/backend/apiEngineering/policies/security.md +36 -0
  14. package/skills/backend/apiEngineering/references/apiObservability.md +39 -0
  15. package/skills/backend/apiEngineering/references/apiReference.md +3 -0
  16. package/skills/backend/apiEngineering/references/apiSecurityOwasp.md +47 -0
  17. package/skills/backend/apiEngineering/references/contractCompatibility.md +26 -0
  18. package/skills/backend/apiEngineering/references/databaseTransactions.md +40 -0
  19. package/skills/backend/apiEngineering/references/distributedReliability.md +26 -0
  20. package/skills/backend/apiEngineering/references/multiTenancy.md +27 -0
  21. package/skills/backend/apiEngineering/references/openApi32Standards.md +58 -0
  22. package/skills/backend/apiEngineering/references/paginationVersioning.md +57 -0
  23. package/skills/backend/apiEngineering/references/responseStandards.md +94 -0
  24. package/skills/backend/apiEngineering/scripts/auditApiContract.py +123 -0
  25. package/skills/backend/apiEngineering/scripts/checkBreakingChanges.py +77 -0
  26. package/skills/backend/apiEngineering/scripts/generateResponseEnvelope.py +88 -0
  27. package/skills/backend/apiEngineering/templates/apiChecklist.md +27 -0
  28. package/skills/backend/apiEngineering/templates/openapi.yaml +125 -0
  29. package/skills/backend/apiEngineering/templates/problemDetails.json +44 -0
  30. package/skills/backend/databaseArchitecture/SKILL.md +118 -0
  31. package/skills/backend/databaseArchitecture/evals/evalDatabaseArchitecture.py +85 -0
  32. package/skills/backend/databaseArchitecture/evals/fixtures/dangerousMigration.sql +4 -0
  33. package/skills/backend/databaseArchitecture/evals/fixtures/invalidSchema.sql +23 -0
  34. package/skills/backend/databaseArchitecture/evals/fixtures/safeMigration.sql +3 -0
  35. package/skills/backend/databaseArchitecture/evals/fixtures/validSchema.sql +37 -0
  36. package/skills/backend/databaseArchitecture/policies/integrity.md +25 -0
  37. package/skills/backend/databaseArchitecture/policies/mandatory.md +32 -0
  38. package/skills/backend/databaseArchitecture/policies/migration.md +22 -0
  39. package/skills/backend/databaseArchitecture/policies/normalization.md +25 -0
  40. package/skills/backend/databaseArchitecture/policies/performance.md +26 -0
  41. package/skills/backend/databaseArchitecture/policies/recovery.md +23 -0
  42. package/skills/backend/databaseArchitecture/policies/security.md +26 -0
  43. package/skills/backend/databaseArchitecture/policies/tableCreationChecklist.md +70 -0
  44. package/skills/backend/databaseArchitecture/references/analyticsWarehousing.md +32 -0
  45. package/skills/backend/databaseArchitecture/references/apiReference.md +3 -0
  46. package/skills/backend/databaseArchitecture/references/backupDisasterRecovery.md +27 -0
  47. package/skills/backend/databaseArchitecture/references/dataModelingLifecycle.md +30 -0
  48. package/skills/backend/databaseArchitecture/references/databaseTaxonomy.md +32 -0
  49. package/skills/backend/databaseArchitecture/references/indexingOptimization.md +32 -0
  50. package/skills/backend/databaseArchitecture/references/normalizationTheory.md +61 -0
  51. package/skills/backend/databaseArchitecture/references/scalabilitySharding.md +37 -0
  52. package/skills/backend/databaseArchitecture/references/transactionConcurrency.md +39 -0
  53. package/skills/backend/databaseArchitecture/scripts/analyzeMigration.py +99 -0
  54. package/skills/backend/databaseArchitecture/scripts/auditDatabaseSchema.py +177 -0
  55. package/skills/backend/databaseArchitecture/scripts/inspectDatabaseIndexes.py +149 -0
  56. package/skills/backend/databaseArchitecture/templates/adrTemplate.md +32 -0
  57. package/skills/backend/databaseArchitecture/templates/databaseChecklist.md +29 -0
  58. package/skills/backend/databaseArchitecture/templates/migrationPlan.md +40 -0
  59. package/skills/backend/durableBackgroundJobs/SKILL.md +112 -0
  60. package/skills/backend/durableBackgroundJobs/evals/durableJobVerification.json +14 -0
  61. package/skills/backend/durableBackgroundJobs/references/apiReference.md +3 -0
  62. package/skills/backend/durableBackgroundJobs/references/durableStepPatterns.md +6 -0
  63. package/skills/backend/durableBackgroundJobs/references/idempotencyKeys.md +5 -0
  64. package/skills/backend/durableBackgroundJobs/scripts/testWorkflowDispatch.py +24 -0
  65. package/skills/backend/golangStandard/SKILL.md +155 -0
  66. package/skills/backend/golangStandard/evals/goVerification.json +14 -0
  67. package/skills/backend/golangStandard/references/apiReference.md +3 -0
  68. package/skills/backend/golangStandard/references/layoutGuide.md +26 -0
  69. package/skills/backend/golangStandard/references/slogPatterns.md +26 -0
  70. package/skills/backend/golangStandard/scripts/scaffoldGoModule.py +105 -0
  71. package/skills/backend/pythonStandard/SKILL.md +138 -0
  72. package/skills/backend/pythonStandard/evals/pythonVerification.json +14 -0
  73. package/skills/backend/pythonStandard/references/apiReference.md +3 -0
  74. package/skills/backend/pythonStandard/references/pydanticPatterns.md +16 -0
  75. package/skills/backend/pythonStandard/references/pyprojectSpecs.md +37 -0
  76. package/skills/backend/pythonStandard/scripts/scaffoldUvProject.py +79 -0
  77. package/skills/backend/upstash/SKILL.md +98 -0
  78. package/skills/backend/upstash/evals/upstashVerification.json +14 -0
  79. package/skills/backend/upstash/references/apiReference.md +3 -0
  80. package/skills/backend/upstash/references/qstashFlowControl.md +34 -0
  81. package/skills/backend/upstash/references/ratelimitPatterns.md +53 -0
  82. package/skills/backend/upstash/references/workflowPatterns.md +35 -0
  83. package/skills/backend/upstash/scripts/testRedisConnection.py +36 -0
  84. package/skills/cicdDevops/cicdPipeline/SKILL.md +148 -0
  85. package/skills/cicdDevops/cicdPipeline/evals/evalCicd.py +37 -0
  86. package/skills/cicdDevops/cicdPipeline/references/apiReference.md +3 -0
  87. package/skills/cicdDevops/cicdPipeline/references/cicdDeploymentPatterns.md +27 -0
  88. package/skills/cicdDevops/cicdPipeline/scripts/auditDockerfileSecurity.py +56 -0
  89. package/skills/dataAi/mcpServerDevelopment/SKILL.md +123 -0
  90. package/skills/dataAi/mcpServerDevelopment/evals/mcpVerification.json +14 -0
  91. package/skills/dataAi/mcpServerDevelopment/references/apiReference.md +3 -0
  92. package/skills/dataAi/mcpServerDevelopment/references/mcpClientConfigs.md +38 -0
  93. package/skills/dataAi/mcpServerDevelopment/references/toolSchemaDesign.md +6 -0
  94. package/skills/dataAi/mcpServerDevelopment/scripts/runFastMcpBoilerplate.py +36 -0
  95. package/skills/dataAi/ragPipelineProduction/SKILL.md +113 -0
  96. package/skills/dataAi/ragPipelineProduction/evals/ragVerification.json +14 -0
  97. package/skills/dataAi/ragPipelineProduction/references/apiReference.md +3 -0
  98. package/skills/dataAi/ragPipelineProduction/references/chunkingStrategies.md +10 -0
  99. package/skills/dataAi/ragPipelineProduction/references/rrfAlgorithm.md +13 -0
  100. package/skills/dataAi/ragPipelineProduction/scripts/runHybridRrfSearch.py +33 -0
  101. package/skills/devopsCloud/cloudflare/SKILL.md +282 -0
  102. package/skills/devopsCloud/cloudflare/assets/README.md +48 -0
  103. package/skills/devopsCloud/cloudflare/assets/ai/agents-sdk.md +118 -0
  104. package/skills/devopsCloud/cloudflare/assets/ai/ai-gateway.md +105 -0
  105. package/skills/devopsCloud/cloudflare/assets/ai/ai-search.md +129 -0
  106. package/skills/devopsCloud/cloudflare/assets/ai/workers-ai.md +127 -0
  107. package/skills/devopsCloud/cloudflare/assets/cli/c3.md +292 -0
  108. package/skills/devopsCloud/cloudflare/assets/cli/cf-cli.md +90 -0
  109. package/skills/devopsCloud/cloudflare/assets/cli/wrangler.md +43 -0
  110. package/skills/devopsCloud/cloudflare/assets/compute/cron-triggers.md +486 -0
  111. package/skills/devopsCloud/cloudflare/assets/compute/service-bindings.md +251 -0
  112. package/skills/devopsCloud/cloudflare/assets/compute/smart-placement.md +435 -0
  113. package/skills/devopsCloud/cloudflare/assets/compute/static-assets.md +220 -0
  114. package/skills/devopsCloud/cloudflare/assets/compute/workers.md +129 -0
  115. package/skills/devopsCloud/cloudflare/assets/database-storage/d1.md +105 -0
  116. package/skills/devopsCloud/cloudflare/assets/database-storage/durable-objects.md +122 -0
  117. package/skills/devopsCloud/cloudflare/assets/database-storage/hyperdrive.md +210 -0
  118. package/skills/devopsCloud/cloudflare/assets/database-storage/kv.md +198 -0
  119. package/skills/devopsCloud/cloudflare/assets/database-storage/queues.md +105 -0
  120. package/skills/devopsCloud/cloudflare/assets/database-storage/r2.md +105 -0
  121. package/skills/devopsCloud/cloudflare/assets/database-storage/vectorize.md +97 -0
  122. package/skills/devopsCloud/cloudflare/assets/database-storage/workflows.md +141 -0
  123. package/skills/devopsCloud/cloudflare/assets/llms.txt +143 -0
  124. package/skills/devopsCloud/cloudflare/assets/networking-security/cache-cdn.md +109 -0
  125. package/skills/devopsCloud/cloudflare/assets/networking-security/dns.md +71 -0
  126. package/skills/devopsCloud/cloudflare/assets/networking-security/rate-limiting.md +130 -0
  127. package/skills/devopsCloud/cloudflare/assets/networking-security/tunnels.md +57 -0
  128. package/skills/devopsCloud/cloudflare/assets/networking-security/waf.md +143 -0
  129. package/skills/devopsCloud/cloudflare/assets/troubleshooting/1xxx-errors.md +209 -0
  130. package/skills/devopsCloud/cloudflare/assets/troubleshooting/5xx-errors.md +111 -0
  131. package/skills/devopsCloud/cloudflare/assets/troubleshooting/http-status-codes.md +38 -0
  132. package/skills/devopsCloud/cloudflare/evals/evals.json +75 -0
  133. package/skills/devopsCloud/cloudflare/references/ai-gateway/README.md +27 -0
  134. package/skills/devopsCloud/cloudflare/references/ai-gateway/configuration.md +18 -0
  135. package/skills/devopsCloud/cloudflare/references/ai-gateway/dynamic-routing.md +15 -0
  136. package/skills/devopsCloud/cloudflare/references/ai-gateway/features.md +22 -0
  137. package/skills/devopsCloud/cloudflare/references/ai-gateway/sdk-integration.md +19 -0
  138. package/skills/devopsCloud/cloudflare/references/ai-gateway/troubleshooting.md +16 -0
  139. package/skills/devopsCloud/cloudflare/references/ai-search/README.md +25 -0
  140. package/skills/devopsCloud/cloudflare/references/ai-search/api.md +13 -0
  141. package/skills/devopsCloud/cloudflare/references/ai-search/configuration.md +16 -0
  142. package/skills/devopsCloud/cloudflare/references/ai-search/gotchas.md +13 -0
  143. package/skills/devopsCloud/cloudflare/references/ai-search/patterns.md +15 -0
  144. package/skills/devopsCloud/cloudflare/references/bindings/README.md +16 -0
  145. package/skills/devopsCloud/cloudflare/references/bindings/api.md +19 -0
  146. package/skills/devopsCloud/cloudflare/references/bindings/configuration.md +20 -0
  147. package/skills/devopsCloud/cloudflare/references/bindings/gotchas.md +18 -0
  148. package/skills/devopsCloud/cloudflare/references/bindings/patterns.md +20 -0
  149. package/skills/devopsCloud/cloudflare/references/browser-rendering/README.md +18 -0
  150. package/skills/devopsCloud/cloudflare/references/browser-rendering/api.md +12 -0
  151. package/skills/devopsCloud/cloudflare/references/browser-rendering/configuration.md +12 -0
  152. package/skills/devopsCloud/cloudflare/references/browser-rendering/gotchas.md +15 -0
  153. package/skills/devopsCloud/cloudflare/references/browser-rendering/patterns.md +12 -0
  154. package/skills/devopsCloud/cloudflare/references/cliComparison.md +93 -0
  155. package/skills/devopsCloud/cloudflare/references/containers/README.md +23 -0
  156. package/skills/devopsCloud/cloudflare/references/containers/api.md +13 -0
  157. package/skills/devopsCloud/cloudflare/references/containers/configuration.md +15 -0
  158. package/skills/devopsCloud/cloudflare/references/containers/gotchas.md +16 -0
  159. package/skills/devopsCloud/cloudflare/references/containers/patterns.md +18 -0
  160. package/skills/devopsCloud/cloudflare/references/cron-triggers/README.md +20 -0
  161. package/skills/devopsCloud/cloudflare/references/cron-triggers/api.md +16 -0
  162. package/skills/devopsCloud/cloudflare/references/cron-triggers/configuration.md +16 -0
  163. package/skills/devopsCloud/cloudflare/references/cron-triggers/gotchas.md +17 -0
  164. package/skills/devopsCloud/cloudflare/references/cron-triggers/patterns.md +18 -0
  165. package/skills/devopsCloud/cloudflare/references/d1/README.md +15 -0
  166. package/skills/devopsCloud/cloudflare/references/d1/api.md +18 -0
  167. package/skills/devopsCloud/cloudflare/references/d1/configuration.md +18 -0
  168. package/skills/devopsCloud/cloudflare/references/d1/gotchas.md +18 -0
  169. package/skills/devopsCloud/cloudflare/references/d1/patterns.md +21 -0
  170. package/skills/devopsCloud/cloudflare/references/frameworkCompatibility.md +110 -0
  171. package/skills/devopsCloud/cloudflare/references/hyperdrive/README.md +28 -0
  172. package/skills/devopsCloud/cloudflare/references/hyperdrive/api.md +26 -0
  173. package/skills/devopsCloud/cloudflare/references/hyperdrive/configuration.md +34 -0
  174. package/skills/devopsCloud/cloudflare/references/hyperdrive/gotchas.md +20 -0
  175. package/skills/devopsCloud/cloudflare/references/hyperdrive/patterns.md +15 -0
  176. package/skills/devopsCloud/cloudflare/references/images/README.md +12 -0
  177. package/skills/devopsCloud/cloudflare/references/images/api.md +13 -0
  178. package/skills/devopsCloud/cloudflare/references/images/configuration.md +17 -0
  179. package/skills/devopsCloud/cloudflare/references/images/gotchas.md +16 -0
  180. package/skills/devopsCloud/cloudflare/references/images/patterns.md +16 -0
  181. package/skills/devopsCloud/cloudflare/references/kv/README.md +15 -0
  182. package/skills/devopsCloud/cloudflare/references/kv/api.md +18 -0
  183. package/skills/devopsCloud/cloudflare/references/kv/configuration.md +16 -0
  184. package/skills/devopsCloud/cloudflare/references/kv/gotchas.md +17 -0
  185. package/skills/devopsCloud/cloudflare/references/kv/patterns.md +21 -0
  186. package/skills/devopsCloud/cloudflare/references/miniflare/README.md +22 -0
  187. package/skills/devopsCloud/cloudflare/references/miniflare/api.md +16 -0
  188. package/skills/devopsCloud/cloudflare/references/miniflare/configuration.md +16 -0
  189. package/skills/devopsCloud/cloudflare/references/miniflare/gotchas.md +15 -0
  190. package/skills/devopsCloud/cloudflare/references/miniflare/patterns.md +19 -0
  191. package/skills/devopsCloud/cloudflare/references/observability/README.md +27 -0
  192. package/skills/devopsCloud/cloudflare/references/observability/api.md +20 -0
  193. package/skills/devopsCloud/cloudflare/references/observability/configuration.md +23 -0
  194. package/skills/devopsCloud/cloudflare/references/observability/gotchas.md +25 -0
  195. package/skills/devopsCloud/cloudflare/references/observability/patterns.md +14 -0
  196. package/skills/devopsCloud/cloudflare/references/pages/README.md +20 -0
  197. package/skills/devopsCloud/cloudflare/references/pages/api.md +13 -0
  198. package/skills/devopsCloud/cloudflare/references/pages/configuration.md +16 -0
  199. package/skills/devopsCloud/cloudflare/references/pages/gotchas.md +19 -0
  200. package/skills/devopsCloud/cloudflare/references/pages/patterns.md +15 -0
  201. package/skills/devopsCloud/cloudflare/references/pages-functions/README.md +20 -0
  202. package/skills/devopsCloud/cloudflare/references/pages-functions/api.md +13 -0
  203. package/skills/devopsCloud/cloudflare/references/pages-functions/configuration.md +14 -0
  204. package/skills/devopsCloud/cloudflare/references/pages-functions/gotchas.md +17 -0
  205. package/skills/devopsCloud/cloudflare/references/pages-functions/patterns.md +16 -0
  206. package/skills/devopsCloud/cloudflare/references/productSelectionMatrix.md +54 -0
  207. package/skills/devopsCloud/cloudflare/references/queues/README.md +24 -0
  208. package/skills/devopsCloud/cloudflare/references/queues/api.md +16 -0
  209. package/skills/devopsCloud/cloudflare/references/queues/configuration.md +20 -0
  210. package/skills/devopsCloud/cloudflare/references/queues/gotchas.md +18 -0
  211. package/skills/devopsCloud/cloudflare/references/queues/patterns.md +21 -0
  212. package/skills/devopsCloud/cloudflare/references/r2/README.md +26 -0
  213. package/skills/devopsCloud/cloudflare/references/r2/api.md +16 -0
  214. package/skills/devopsCloud/cloudflare/references/r2/configuration.md +19 -0
  215. package/skills/devopsCloud/cloudflare/references/r2/gotchas.md +17 -0
  216. package/skills/devopsCloud/cloudflare/references/r2/patterns.md +18 -0
  217. package/skills/devopsCloud/cloudflare/references/secrets-store/README.md +22 -0
  218. package/skills/devopsCloud/cloudflare/references/secrets-store/api.md +21 -0
  219. package/skills/devopsCloud/cloudflare/references/secrets-store/configuration.md +25 -0
  220. package/skills/devopsCloud/cloudflare/references/secrets-store/gotchas.md +19 -0
  221. package/skills/devopsCloud/cloudflare/references/secrets-store/patterns.md +27 -0
  222. package/skills/devopsCloud/cloudflare/references/skill-feedback.md +41 -0
  223. package/skills/devopsCloud/cloudflare/references/static-assets/README.md +21 -0
  224. package/skills/devopsCloud/cloudflare/references/static-assets/api.md +16 -0
  225. package/skills/devopsCloud/cloudflare/references/static-assets/configuration.md +16 -0
  226. package/skills/devopsCloud/cloudflare/references/static-assets/gotchas.md +18 -0
  227. package/skills/devopsCloud/cloudflare/references/static-assets/patterns.md +17 -0
  228. package/skills/devopsCloud/cloudflare/references/stream/README.md +22 -0
  229. package/skills/devopsCloud/cloudflare/references/stream/api-live.md +18 -0
  230. package/skills/devopsCloud/cloudflare/references/stream/api.md +21 -0
  231. package/skills/devopsCloud/cloudflare/references/stream/configuration.md +18 -0
  232. package/skills/devopsCloud/cloudflare/references/stream/gotchas.md +18 -0
  233. package/skills/devopsCloud/cloudflare/references/stream/patterns.md +22 -0
  234. package/skills/devopsCloud/cloudflare/references/tail-workers/README.md +21 -0
  235. package/skills/devopsCloud/cloudflare/references/tail-workers/api.md +13 -0
  236. package/skills/devopsCloud/cloudflare/references/tail-workers/configuration.md +15 -0
  237. package/skills/devopsCloud/cloudflare/references/tail-workers/gotchas.md +16 -0
  238. package/skills/devopsCloud/cloudflare/references/tail-workers/patterns.md +15 -0
  239. package/skills/devopsCloud/cloudflare/references/tunnel/README.md +20 -0
  240. package/skills/devopsCloud/cloudflare/references/tunnel/api.md +14 -0
  241. package/skills/devopsCloud/cloudflare/references/tunnel/configuration.md +14 -0
  242. package/skills/devopsCloud/cloudflare/references/tunnel/gotchas.md +15 -0
  243. package/skills/devopsCloud/cloudflare/references/tunnel/networking.md +14 -0
  244. package/skills/devopsCloud/cloudflare/references/tunnel/patterns.md +15 -0
  245. package/skills/devopsCloud/cloudflare/references/vectorize/README.md +22 -0
  246. package/skills/devopsCloud/cloudflare/references/vectorize/api.md +18 -0
  247. package/skills/devopsCloud/cloudflare/references/vectorize/configuration.md +19 -0
  248. package/skills/devopsCloud/cloudflare/references/vectorize/gotchas.md +15 -0
  249. package/skills/devopsCloud/cloudflare/references/vectorize/patterns.md +24 -0
  250. package/skills/devopsCloud/cloudflare/references/waf/README.md +21 -0
  251. package/skills/devopsCloud/cloudflare/references/waf/api.md +17 -0
  252. package/skills/devopsCloud/cloudflare/references/waf/configuration.md +18 -0
  253. package/skills/devopsCloud/cloudflare/references/waf/gotchas.md +19 -0
  254. package/skills/devopsCloud/cloudflare/references/waf/patterns.md +17 -0
  255. package/skills/devopsCloud/cloudflare/references/workers-ai/README.md +24 -0
  256. package/skills/devopsCloud/cloudflare/references/workers-ai/api.md +13 -0
  257. package/skills/devopsCloud/cloudflare/references/workers-ai/configuration.md +16 -0
  258. package/skills/devopsCloud/cloudflare/references/workers-ai/gotchas.md +15 -0
  259. package/skills/devopsCloud/cloudflare/references/workers-ai/patterns.md +14 -0
  260. package/skills/devopsCloud/cloudflare/references/workflows/README.md +23 -0
  261. package/skills/devopsCloud/cloudflare/references/workflows/api.md +17 -0
  262. package/skills/devopsCloud/cloudflare/references/workflows/configuration.md +18 -0
  263. package/skills/devopsCloud/cloudflare/references/workflows/gotchas.md +19 -0
  264. package/skills/devopsCloud/cloudflare/references/workflows/patterns.md +30 -0
  265. package/skills/devopsCloud/cloudflare/scripts/auditCloudflareProduction.py +95 -0
  266. package/skills/foundation/promptEvalTesting/SKILL.md +114 -0
  267. package/skills/foundation/promptEvalTesting/evals/promptEvalVerification.json +14 -0
  268. package/skills/foundation/promptEvalTesting/references/apiReference.md +3 -0
  269. package/skills/foundation/promptEvalTesting/references/evalMetricsCatalog.md +7 -0
  270. package/skills/foundation/promptEvalTesting/references/promptfooConfigSpecs.md +16 -0
  271. package/skills/foundation/promptEvalTesting/scripts/runPromptEvalSuite.py +29 -0
  272. package/skills/frontend/astro/SKILL.md +327 -0
  273. package/skills/frontend/astro/assets/README.md +71 -0
  274. package/skills/frontend/astro/assets/add-content-to-your-site/content-collections.md +1061 -0
  275. package/skills/frontend/astro/assets/add-content-to-your-site/data-fetching.md +109 -0
  276. package/skills/frontend/astro/assets/add-content-to-your-site/images.md +719 -0
  277. package/skills/frontend/astro/assets/add-content-to-your-site/markdown.md +725 -0
  278. package/skills/frontend/astro/assets/build-your-ui/components.md +402 -0
  279. package/skills/frontend/astro/assets/build-your-ui/fonts.md +437 -0
  280. package/skills/frontend/astro/assets/build-your-ui/front-end-frameworks.md +245 -0
  281. package/skills/frontend/astro/assets/build-your-ui/layouts.md +267 -0
  282. package/skills/frontend/astro/assets/build-your-ui/scripts-and-event-handling.md +229 -0
  283. package/skills/frontend/astro/assets/build-your-ui/styles-and-css.md +782 -0
  284. package/skills/frontend/astro/assets/build-your-ui/syntax-highlighting.md +269 -0
  285. package/skills/frontend/astro/assets/configuration/build-with-ai.md +389 -0
  286. package/skills/frontend/astro/assets/configuration/configuration-overview.md +122 -0
  287. package/skills/frontend/astro/assets/configuration/dev-toolbar.md +86 -0
  288. package/skills/frontend/astro/assets/configuration/editor-setup.md +166 -0
  289. package/skills/frontend/astro/assets/configuration/environment-variables.md +352 -0
  290. package/skills/frontend/astro/assets/configuration/typescript.md +379 -0
  291. package/skills/frontend/astro/assets/configuration/working-with-integrations.md +606 -0
  292. package/skills/frontend/astro/assets/reference/adapter-reference.md +1242 -0
  293. package/skills/frontend/astro/assets/reference/cli-reference.md +575 -0
  294. package/skills/frontend/astro/assets/reference/configuration-reference.md +3144 -0
  295. package/skills/frontend/astro/assets/reference/content-loader-reference.md +1682 -0
  296. package/skills/frontend/astro/assets/reference/directives-reference.md +324 -0
  297. package/skills/frontend/astro/assets/reference/image-service-reference.md +346 -0
  298. package/skills/frontend/astro/assets/reference/integrations-reference.md +2813 -0
  299. package/skills/frontend/astro/assets/reference/modules/astro-actions.md +604 -0
  300. package/skills/frontend/astro/assets/reference/modules/astro-app.md +460 -0
  301. package/skills/frontend/astro/assets/reference/modules/astro-assets.md +1657 -0
  302. package/skills/frontend/astro/assets/reference/modules/astro-config.md +395 -0
  303. package/skills/frontend/astro/assets/reference/modules/astro-content.md +720 -0
  304. package/skills/frontend/astro/assets/reference/modules/astro-env.md +46 -0
  305. package/skills/frontend/astro/assets/reference/modules/astro-fetch.md +346 -0
  306. package/skills/frontend/astro/assets/reference/modules/astro-hono.md +37 -0
  307. package/skills/frontend/astro/assets/reference/modules/astro-i18n.md +462 -0
  308. package/skills/frontend/astro/assets/reference/modules/astro-middleware.md +292 -0
  309. package/skills/frontend/astro/assets/reference/modules/astro-static-paths.md +74 -0
  310. package/skills/frontend/astro/assets/reference/modules/astro-transitions.md +595 -0
  311. package/skills/frontend/astro/assets/reference/modules/astro-zod.md +120 -0
  312. package/skills/frontend/astro/assets/reference/session-driver-reference.md +205 -0
  313. package/skills/frontend/astro/assets/routing-and-navigation/endpoints.md +251 -0
  314. package/skills/frontend/astro/assets/routing-and-navigation/internationalization.md +374 -0
  315. package/skills/frontend/astro/assets/routing-and-navigation/middleware.md +288 -0
  316. package/skills/frontend/astro/assets/routing-and-navigation/pages.md +205 -0
  317. package/skills/frontend/astro/assets/routing-and-navigation/prefetch.md +273 -0
  318. package/skills/frontend/astro/assets/routing-and-navigation/routing.md +760 -0
  319. package/skills/frontend/astro/assets/routing-and-navigation/view-transitions.md +792 -0
  320. package/skills/frontend/astro/assets/server-rendering/actions.md +770 -0
  321. package/skills/frontend/astro/assets/server-rendering/caching.md +255 -0
  322. package/skills/frontend/astro/assets/server-rendering/on-demand-rendering.md +289 -0
  323. package/skills/frontend/astro/assets/server-rendering/server-islands.md +126 -0
  324. package/skills/frontend/astro/assets/server-rendering/sessions.md +270 -0
  325. package/skills/frontend/astro/assets/start-a-new-project/develop-and-build.md +147 -0
  326. package/skills/frontend/astro/assets/start-a-new-project/installation.md +342 -0
  327. package/skills/frontend/astro/assets/start-a-new-project/project-structure.md +137 -0
  328. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/testing.md +412 -0
  329. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/troubleshooting.md +229 -0
  330. package/skills/frontend/astro/assets/upgrade-and-troubleshooting/upgrade-astro.md +205 -0
  331. package/skills/frontend/astro/assets/welcome/courses.md +46 -0
  332. package/skills/frontend/astro/assets/welcome/islands-architecture.md +135 -0
  333. package/skills/frontend/astro/assets/welcome/why-astro.md +90 -0
  334. package/skills/frontend/astro/evals/evals.json +66 -0
  335. package/skills/frontend/astro/references/contentCollections.md +164 -0
  336. package/skills/frontend/astro/references/islandsArchitecture.md +128 -0
  337. package/skills/frontend/astro/references/serverIslandsAndActions.md +187 -0
  338. package/skills/frontend/astro/scripts/auditAstroProduction.py +78 -0
  339. package/skills/frontend/generativeUi/SKILL.md +128 -0
  340. package/skills/frontend/generativeUi/evals/generativeUiVerification.json +14 -0
  341. package/skills/frontend/generativeUi/references/apiReference.md +3 -0
  342. package/skills/frontend/generativeUi/references/clientToolComponentMapping.md +8 -0
  343. package/skills/frontend/generativeUi/references/dataStreamProtocol.md +10 -0
  344. package/skills/frontend/generativeUi/scripts/generateUiComponentStub.py +46 -0
  345. package/skills/frontend/nextjs/SKILL.md +138 -0
  346. package/skills/frontend/nextjs/assets/README.md +67 -0
  347. package/skills/frontend/nextjs/assets/api-reference/cli/create-next-app.md +210 -0
  348. package/skills/frontend/nextjs/assets/api-reference/cli/next.md +484 -0
  349. package/skills/frontend/nextjs/assets/api-reference/components/font.md +952 -0
  350. package/skills/frontend/nextjs/assets/api-reference/components/form.md +387 -0
  351. package/skills/frontend/nextjs/assets/api-reference/components/image.md +1372 -0
  352. package/skills/frontend/nextjs/assets/api-reference/components/link.md +954 -0
  353. package/skills/frontend/nextjs/assets/api-reference/components/script.md +421 -0
  354. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-private.md +211 -0
  355. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache-remote.md +652 -0
  356. package/skills/frontend/nextjs/assets/api-reference/directives/use-cache.md +848 -0
  357. package/skills/frontend/nextjs/assets/api-reference/directives/use-client.md +149 -0
  358. package/skills/frontend/nextjs/assets/api-reference/directives/use-server.md +234 -0
  359. package/skills/frontend/nextjs/assets/api-reference/edge-runtime.md +188 -0
  360. package/skills/frontend/nextjs/assets/api-reference/file-conventions/default.md +80 -0
  361. package/skills/frontend/nextjs/assets/api-reference/file-conventions/dynamic-routes.md +417 -0
  362. package/skills/frontend/nextjs/assets/api-reference/file-conventions/error.md +361 -0
  363. package/skills/frontend/nextjs/assets/api-reference/file-conventions/forbidden.md +75 -0
  364. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation-client.md +308 -0
  365. package/skills/frontend/nextjs/assets/api-reference/file-conventions/instrumentation.md +177 -0
  366. package/skills/frontend/nextjs/assets/api-reference/file-conventions/intercepting-routes.md +78 -0
  367. package/skills/frontend/nextjs/assets/api-reference/file-conventions/layout.md +803 -0
  368. package/skills/frontend/nextjs/assets/api-reference/file-conventions/loading.md +209 -0
  369. package/skills/frontend/nextjs/assets/api-reference/file-conventions/mdx-components.md +84 -0
  370. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/app-icons.md +302 -0
  371. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/manifest.md +90 -0
  372. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/opengraph-image.md +580 -0
  373. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/robots.md +234 -0
  374. package/skills/frontend/nextjs/assets/api-reference/file-conventions/metadata/sitemap.md +459 -0
  375. package/skills/frontend/nextjs/assets/api-reference/file-conventions/not-found.md +278 -0
  376. package/skills/frontend/nextjs/assets/api-reference/file-conventions/page.md +283 -0
  377. package/skills/frontend/nextjs/assets/api-reference/file-conventions/parallel-routes.md +517 -0
  378. package/skills/frontend/nextjs/assets/api-reference/file-conventions/proxy.md +857 -0
  379. package/skills/frontend/nextjs/assets/api-reference/file-conventions/public-folder.md +47 -0
  380. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-groups.md +40 -0
  381. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/dynamicParams.md +40 -0
  382. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/ensureStatic.md +195 -0
  383. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/instant.md +204 -0
  384. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/maxDuration.md +42 -0
  385. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/preferredRegion.md +55 -0
  386. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/prefetch.md +113 -0
  387. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route-segment-config/runtime.md +43 -0
  388. package/skills/frontend/nextjs/assets/api-reference/file-conventions/route.md +772 -0
  389. package/skills/frontend/nextjs/assets/api-reference/file-conventions/src-folder.md +42 -0
  390. package/skills/frontend/nextjs/assets/api-reference/file-conventions/template.md +174 -0
  391. package/skills/frontend/nextjs/assets/api-reference/file-conventions/unauthorized.md +143 -0
  392. package/skills/frontend/nextjs/assets/api-reference/functions/after.md +332 -0
  393. package/skills/frontend/nextjs/assets/api-reference/functions/cacheLife.md +642 -0
  394. package/skills/frontend/nextjs/assets/api-reference/functions/cacheTag.md +272 -0
  395. package/skills/frontend/nextjs/assets/api-reference/functions/catchError.md +267 -0
  396. package/skills/frontend/nextjs/assets/api-reference/functions/connection.md +114 -0
  397. package/skills/frontend/nextjs/assets/api-reference/functions/cookies.md +349 -0
  398. package/skills/frontend/nextjs/assets/api-reference/functions/draft-mode.md +173 -0
  399. package/skills/frontend/nextjs/assets/api-reference/functions/fetch.md +141 -0
  400. package/skills/frontend/nextjs/assets/api-reference/functions/forbidden.md +327 -0
  401. package/skills/frontend/nextjs/assets/api-reference/functions/generate-image-metadata.md +311 -0
  402. package/skills/frontend/nextjs/assets/api-reference/functions/generate-metadata.md +1510 -0
  403. package/skills/frontend/nextjs/assets/api-reference/functions/generate-sitemaps.md +102 -0
  404. package/skills/frontend/nextjs/assets/api-reference/functions/generate-static-params.md +606 -0
  405. package/skills/frontend/nextjs/assets/api-reference/functions/generate-viewport.md +347 -0
  406. package/skills/frontend/nextjs/assets/api-reference/functions/headers.md +92 -0
  407. package/skills/frontend/nextjs/assets/api-reference/functions/image-response.md +225 -0
  408. package/skills/frontend/nextjs/assets/api-reference/functions/io.md +131 -0
  409. package/skills/frontend/nextjs/assets/api-reference/functions/navigation.md +220 -0
  410. package/skills/frontend/nextjs/assets/api-reference/functions/next-request.md +116 -0
  411. package/skills/frontend/nextjs/assets/api-reference/functions/next-response.md +219 -0
  412. package/skills/frontend/nextjs/assets/api-reference/functions/next-root-params.md +479 -0
  413. package/skills/frontend/nextjs/assets/api-reference/functions/not-found.md +269 -0
  414. package/skills/frontend/nextjs/assets/api-reference/functions/permanentRedirect.md +92 -0
  415. package/skills/frontend/nextjs/assets/api-reference/functions/prefetch.md +202 -0
  416. package/skills/frontend/nextjs/assets/api-reference/functions/redirect.md +255 -0
  417. package/skills/frontend/nextjs/assets/api-reference/functions/refresh.md +91 -0
  418. package/skills/frontend/nextjs/assets/api-reference/functions/revalidatePath.md +248 -0
  419. package/skills/frontend/nextjs/assets/api-reference/functions/revalidateTag.md +175 -0
  420. package/skills/frontend/nextjs/assets/api-reference/functions/unauthorized.md +389 -0
  421. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_cache.md +131 -0
  422. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_noStore.md +61 -0
  423. package/skills/frontend/nextjs/assets/api-reference/functions/unstable_rethrow.md +79 -0
  424. package/skills/frontend/nextjs/assets/api-reference/functions/updateTag.md +173 -0
  425. package/skills/frontend/nextjs/assets/api-reference/functions/use-link-status.md +268 -0
  426. package/skills/frontend/nextjs/assets/api-reference/functions/use-offline.md +222 -0
  427. package/skills/frontend/nextjs/assets/api-reference/functions/use-params.md +102 -0
  428. package/skills/frontend/nextjs/assets/api-reference/functions/use-pathname.md +189 -0
  429. package/skills/frontend/nextjs/assets/api-reference/functions/use-report-web-vitals.md +175 -0
  430. package/skills/frontend/nextjs/assets/api-reference/functions/use-router.md +214 -0
  431. package/skills/frontend/nextjs/assets/api-reference/functions/use-search-params.md +416 -0
  432. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segment.md +214 -0
  433. package/skills/frontend/nextjs/assets/api-reference/functions/use-selected-layout-segments.md +116 -0
  434. package/skills/frontend/nextjs/assets/api-reference/functions/use-server-inserted-html.md +145 -0
  435. package/skills/frontend/nextjs/assets/api-reference/functions/userAgent.md +95 -0
  436. package/skills/frontend/nextjs/assets/api-reference/turbopack.md +552 -0
  437. package/skills/frontend/nextjs/assets/architecture/accessibility.md +47 -0
  438. package/skills/frontend/nextjs/assets/architecture/fast-refresh.md +122 -0
  439. package/skills/frontend/nextjs/assets/architecture/nextjs-compiler.md +376 -0
  440. package/skills/frontend/nextjs/assets/architecture/supported-browsers.md +146 -0
  441. package/skills/frontend/nextjs/assets/community/contribution-guide.md +459 -0
  442. package/skills/frontend/nextjs/assets/community/rspack.md +25 -0
  443. package/skills/frontend/nextjs/assets/getting-started/caching.md +626 -0
  444. package/skills/frontend/nextjs/assets/getting-started/css.md +336 -0
  445. package/skills/frontend/nextjs/assets/getting-started/deploying.md +115 -0
  446. package/skills/frontend/nextjs/assets/getting-started/error-handling.md +485 -0
  447. package/skills/frontend/nextjs/assets/getting-started/fetching-data.md +743 -0
  448. package/skills/frontend/nextjs/assets/getting-started/fonts.md +232 -0
  449. package/skills/frontend/nextjs/assets/getting-started/images.md +272 -0
  450. package/skills/frontend/nextjs/assets/getting-started/installation.md +446 -0
  451. package/skills/frontend/nextjs/assets/getting-started/layouts-and-pages.md +386 -0
  452. package/skills/frontend/nextjs/assets/getting-started/linking-and-navigating.md +475 -0
  453. package/skills/frontend/nextjs/assets/getting-started/metadata-and-og-images.md +370 -0
  454. package/skills/frontend/nextjs/assets/getting-started/mutating-data.md +679 -0
  455. package/skills/frontend/nextjs/assets/getting-started/project-structure.md +290 -0
  456. package/skills/frontend/nextjs/assets/getting-started/proxy.md +107 -0
  457. package/skills/frontend/nextjs/assets/getting-started/revalidating.md +241 -0
  458. package/skills/frontend/nextjs/assets/getting-started/route-handlers.md +233 -0
  459. package/skills/frontend/nextjs/assets/getting-started/server-and-client-components.md +683 -0
  460. package/skills/frontend/nextjs/assets/getting-started/upgrading.md +137 -0
  461. package/skills/frontend/nextjs/assets/glossary.md +315 -0
  462. package/skills/frontend/nextjs/evals/nextjsVerification.json +14 -0
  463. package/skills/frontend/nextjs/references/apiReference.md +3 -0
  464. package/skills/frontend/nextjs/references/dataAccessLayer.md +39 -0
  465. package/skills/frontend/nextjs/references/nextjsFeatureMap.md +276 -0
  466. package/skills/frontend/nextjs/references/productionChecklist.md +49 -0
  467. package/skills/frontend/nextjs/references/securityHeadersCsp.md +44 -0
  468. package/skills/frontend/nextjs/scripts/auditProductionReadiness.py +85 -0
  469. package/skills/frontend/shadcn-ui/SKILL.md +102 -0
  470. package/skills/frontend/shadcn-ui/assets/README.md +82 -0
  471. package/skills/frontend/shadcn-ui/assets/advanced/javascript.md +44 -0
  472. package/skills/frontend/shadcn-ui/assets/advanced/monorepo.md +254 -0
  473. package/skills/frontend/shadcn-ui/assets/advanced/react-19.md +166 -0
  474. package/skills/frontend/shadcn-ui/assets/advanced/tailwind-v4.md +333 -0
  475. package/skills/frontend/shadcn-ui/assets/ai-elements/chain-of-thought.md +519 -0
  476. package/skills/frontend/shadcn-ui/assets/ai-elements/chat.md +581 -0
  477. package/skills/frontend/shadcn-ui/assets/ai-elements/checkpoint.md +243 -0
  478. package/skills/frontend/shadcn-ui/assets/ai-elements/confirmation.md +382 -0
  479. package/skills/frontend/shadcn-ui/assets/ai-elements/context.md +188 -0
  480. package/skills/frontend/shadcn-ui/assets/ai-elements/file-tree.md +248 -0
  481. package/skills/frontend/shadcn-ui/assets/ai-elements/index.md +307 -0
  482. package/skills/frontend/shadcn-ui/assets/ai-elements/inline-citation.md +219 -0
  483. package/skills/frontend/shadcn-ui/assets/ai-elements/message.md +298 -0
  484. package/skills/frontend/shadcn-ui/assets/ai-elements/model-selector.md +368 -0
  485. package/skills/frontend/shadcn-ui/assets/ai-elements/plan.md +398 -0
  486. package/skills/frontend/shadcn-ui/assets/ai-elements/prompt-input.md +403 -0
  487. package/skills/frontend/shadcn-ui/assets/ai-elements/queue.md +517 -0
  488. package/skills/frontend/shadcn-ui/assets/ai-elements/reasoning.md +349 -0
  489. package/skills/frontend/shadcn-ui/assets/ai-elements/sources.md +303 -0
  490. package/skills/frontend/shadcn-ui/assets/ai-elements/stack-trace.md +514 -0
  491. package/skills/frontend/shadcn-ui/assets/ai-elements/subagent.md +551 -0
  492. package/skills/frontend/shadcn-ui/assets/ai-elements/suggestion.md +246 -0
  493. package/skills/frontend/shadcn-ui/assets/ai-elements/task.md +380 -0
  494. package/skills/frontend/shadcn-ui/assets/ai-elements/terminal.md +463 -0
  495. package/skills/frontend/shadcn-ui/assets/ai-elements/test-results.md +641 -0
  496. package/skills/frontend/shadcn-ui/assets/ai-elements/tool.md +915 -0
  497. package/skills/frontend/shadcn-ui/assets/components/accordion.md +490 -0
  498. package/skills/frontend/shadcn-ui/assets/components/alert-dialog.md +520 -0
  499. package/skills/frontend/shadcn-ui/assets/components/alert.md +351 -0
  500. package/skills/frontend/shadcn-ui/assets/components/aspect-ratio.md +206 -0
  501. package/skills/frontend/shadcn-ui/assets/components/attachment.md +715 -0
  502. package/skills/frontend/shadcn-ui/assets/components/avatar.md +581 -0
  503. package/skills/frontend/shadcn-ui/assets/components/badge.md +276 -0
  504. package/skills/frontend/shadcn-ui/assets/components/breadcrumb.md +556 -0
  505. package/skills/frontend/shadcn-ui/assets/components/bubble.md +706 -0
  506. package/skills/frontend/shadcn-ui/assets/components/button-group.md +969 -0
  507. package/skills/frontend/shadcn-ui/assets/components/button.md +523 -0
  508. package/skills/frontend/shadcn-ui/assets/components/calendar.md +959 -0
  509. package/skills/frontend/shadcn-ui/assets/components/card.md +684 -0
  510. package/skills/frontend/shadcn-ui/assets/components/carousel.md +643 -0
  511. package/skills/frontend/shadcn-ui/assets/components/chart.md +1295 -0
  512. package/skills/frontend/shadcn-ui/assets/components/checkbox.md +553 -0
  513. package/skills/frontend/shadcn-ui/assets/components/code-block.md +2041 -0
  514. package/skills/frontend/shadcn-ui/assets/components/collapsible.md +504 -0
  515. package/skills/frontend/shadcn-ui/assets/components/combobox.md +1102 -0
  516. package/skills/frontend/shadcn-ui/assets/components/command.md +682 -0
  517. package/skills/frontend/shadcn-ui/assets/components/context-menu.md +949 -0
  518. package/skills/frontend/shadcn-ui/assets/components/data-table.md +1667 -0
  519. package/skills/frontend/shadcn-ui/assets/components/date-picker.md +698 -0
  520. package/skills/frontend/shadcn-ui/assets/components/dialog.md +454 -0
  521. package/skills/frontend/shadcn-ui/assets/components/direction.md +205 -0
  522. package/skills/frontend/shadcn-ui/assets/components/drawer.md +806 -0
  523. package/skills/frontend/shadcn-ui/assets/components/dropdown-menu.md +1315 -0
  524. package/skills/frontend/shadcn-ui/assets/components/empty.md +562 -0
  525. package/skills/frontend/shadcn-ui/assets/components/field.md +1321 -0
  526. package/skills/frontend/shadcn-ui/assets/components/hover-card.md +342 -0
  527. package/skills/frontend/shadcn-ui/assets/components/index.md +82 -0
  528. package/skills/frontend/shadcn-ui/assets/components/input-group.md +980 -0
  529. package/skills/frontend/shadcn-ui/assets/components/input-otp.md +551 -0
  530. package/skills/frontend/shadcn-ui/assets/components/input.md +555 -0
  531. package/skills/frontend/shadcn-ui/assets/components/item.md +937 -0
  532. package/skills/frontend/shadcn-ui/assets/components/kbd.md +290 -0
  533. package/skills/frontend/shadcn-ui/assets/components/label.md +327 -0
  534. package/skills/frontend/shadcn-ui/assets/components/marker.md +445 -0
  535. package/skills/frontend/shadcn-ui/assets/components/menubar.md +804 -0
  536. package/skills/frontend/shadcn-ui/assets/components/message-scroller.md +2770 -0
  537. package/skills/frontend/shadcn-ui/assets/components/message.md +618 -0
  538. package/skills/frontend/shadcn-ui/assets/components/native-select.md +321 -0
  539. package/skills/frontend/shadcn-ui/assets/components/navigation-menu.md +568 -0
  540. package/skills/frontend/shadcn-ui/assets/components/pagination.md +425 -0
  541. package/skills/frontend/shadcn-ui/assets/components/popover.md +402 -0
  542. package/skills/frontend/shadcn-ui/assets/components/progress.md +240 -0
  543. package/skills/frontend/shadcn-ui/assets/components/questionnaire.md +2055 -0
  544. package/skills/frontend/shadcn-ui/assets/components/radio-group.md +440 -0
  545. package/skills/frontend/shadcn-ui/assets/components/resizable.md +302 -0
  546. package/skills/frontend/shadcn-ui/assets/components/scroll-area.md +226 -0
  547. package/skills/frontend/shadcn-ui/assets/components/select.md +647 -0
  548. package/skills/frontend/shadcn-ui/assets/components/separator.md +235 -0
  549. package/skills/frontend/shadcn-ui/assets/components/sheet.md +354 -0
  550. package/skills/frontend/shadcn-ui/assets/components/sidebar.md +1156 -0
  551. package/skills/frontend/shadcn-ui/assets/components/skeleton.md +217 -0
  552. package/skills/frontend/shadcn-ui/assets/components/slider.md +253 -0
  553. package/skills/frontend/shadcn-ui/assets/components/spinner.md +352 -0
  554. package/skills/frontend/shadcn-ui/assets/components/switch.md +296 -0
  555. package/skills/frontend/shadcn-ui/assets/components/table.md +572 -0
  556. package/skills/frontend/shadcn-ui/assets/components/tabs.md +425 -0
  557. package/skills/frontend/shadcn-ui/assets/components/textarea.md +218 -0
  558. package/skills/frontend/shadcn-ui/assets/components/toast.md +260 -0
  559. package/skills/frontend/shadcn-ui/assets/components/toggle-group.md +419 -0
  560. package/skills/frontend/shadcn-ui/assets/components/toggle.md +220 -0
  561. package/skills/frontend/shadcn-ui/assets/components/tooltip.md +332 -0
  562. package/skills/frontend/shadcn-ui/assets/components/trace.md +1890 -0
  563. package/skills/frontend/shadcn-ui/assets/components/typography.md +561 -0
  564. package/skills/frontend/shadcn-ui/assets/dark-mode/next.md +108 -0
  565. package/skills/frontend/shadcn-ui/assets/dark-mode/overview.md +75 -0
  566. package/skills/frontend/shadcn-ui/assets/dark-mode/vite.md +144 -0
  567. package/skills/frontend/shadcn-ui/assets/forms/next.md +716 -0
  568. package/skills/frontend/shadcn-ui/assets/forms/overview.md +60 -0
  569. package/skills/frontend/shadcn-ui/assets/forms/react-hook-form.md +2055 -0
  570. package/skills/frontend/shadcn-ui/assets/forms/tanstack-form.md +2236 -0
  571. package/skills/frontend/shadcn-ui/assets/installation/astro.md +252 -0
  572. package/skills/frontend/shadcn-ui/assets/installation/manual.md +255 -0
  573. package/skills/frontend/shadcn-ui/assets/installation/next.md +256 -0
  574. package/skills/frontend/shadcn-ui/assets/installation/react-router.md +226 -0
  575. package/skills/frontend/shadcn-ui/assets/installation/remix.md +52 -0
  576. package/skills/frontend/shadcn-ui/assets/installation/vite.md +314 -0
  577. package/skills/frontend/shadcn-ui/assets/mcp/mcp.md +338 -0
  578. package/skills/frontend/shadcn-ui/assets/overview/changelog.md +6 -0
  579. package/skills/frontend/shadcn-ui/assets/overview/cli.md +738 -0
  580. package/skills/frontend/shadcn-ui/assets/overview/components-json.md +379 -0
  581. package/skills/frontend/shadcn-ui/assets/overview/directory.md +74 -0
  582. package/skills/frontend/shadcn-ui/assets/overview/introduction.md +77 -0
  583. package/skills/frontend/shadcn-ui/assets/overview/skills.md +71 -0
  584. package/skills/frontend/shadcn-ui/assets/overview/theming.md +304 -0
  585. package/skills/frontend/shadcn-ui/assets/overview/typeset.md +242 -0
  586. package/skills/frontend/shadcn-ui/assets/registry/getting-started.md +648 -0
  587. package/skills/frontend/shadcn-ui/assets/registry/overview.md +90 -0
  588. package/skills/frontend/shadcn-ui/assets/registry/registry-item-json.md +483 -0
  589. package/skills/frontend/shadcn-ui/assets/registry/registry-json.md +178 -0
  590. package/skills/frontend/shadcn-ui/evals/componentVerification.json +19 -0
  591. package/skills/frontend/shadcn-ui/references/aiComponentsCatalog.md +51 -0
  592. package/skills/frontend/shadcn-ui/references/apiReference.md +3 -0
  593. package/skills/frontend/shadcn-ui/references/blocksCatalog.md +32 -0
  594. package/skills/frontend/shadcn-ui/references/cliCommands.md +47 -0
  595. package/skills/frontend/shadcn-ui/references/componentMarkdownSources.md +48 -0
  596. package/skills/frontend/shadcn-ui/scripts/fetchComponentDocs.py +43 -0
  597. package/skills/frontend/tsxReactStandard/SKILL.md +150 -0
  598. package/skills/frontend/tsxReactStandard/evals/tsxVerification.json +14 -0
  599. package/skills/frontend/tsxReactStandard/references/apiReference.md +3 -0
  600. package/skills/frontend/tsxReactStandard/references/discriminatedUnions.md +31 -0
  601. package/skills/frontend/tsxReactStandard/references/tsconfigStrict.md +36 -0
  602. package/skills/frontend/tsxReactStandard/scripts/validateTsxTypes.py +44 -0
  603. package/skills/gitVersionControl/gitWorkflow/SKILL.md +128 -0
  604. package/skills/gitVersionControl/gitWorkflow/assets/README.md +23 -0
  605. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-environment.md +87 -0
  606. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-formatting.md +156 -0
  607. package/skills/gitVersionControl/gitWorkflow/assets/cli/gh-reference.md +2363 -0
  608. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-git.md +156 -0
  609. package/skills/gitVersionControl/gitWorkflow/assets/using-git/about-remote-repositories.md +65 -0
  610. package/skills/gitVersionControl/gitWorkflow/assets/using-git/associating-text-editors-with-git.md +93 -0
  611. package/skills/gitVersionControl/gitWorkflow/assets/using-git/caching-your-github-credentials.md +115 -0
  612. package/skills/gitVersionControl/gitWorkflow/assets/using-git/getting-changes-from-a-remote-repository.md +76 -0
  613. package/skills/gitVersionControl/gitWorkflow/assets/using-git/ignoring-files.md +51 -0
  614. package/skills/gitVersionControl/gitWorkflow/assets/using-git/managing-remote-repositories.md +231 -0
  615. package/skills/gitVersionControl/gitWorkflow/assets/using-git/pushing-commits-to-a-remote-repository.md +119 -0
  616. package/skills/gitVersionControl/gitWorkflow/evals/evalGitWorkflow.py +43 -0
  617. package/skills/gitVersionControl/gitWorkflow/references/apiReference.md +3 -0
  618. package/skills/gitVersionControl/gitWorkflow/references/branchingModels.md +32 -0
  619. package/skills/gitVersionControl/gitWorkflow/scripts/diagnoseGitGraph.py +68 -0
  620. package/skills/github/assets/README.md +39 -0
  621. package/skills/github/assets/cli/gh-environment.md +87 -0
  622. package/skills/github/assets/cli/gh-formatting.md +156 -0
  623. package/skills/github/assets/cli/gh-reference.md +2363 -0
  624. package/skills/github/assets/docs-api/github-docs-api.md +60 -0
  625. package/skills/github/assets/rest-api/actions-secrets.md +1272 -0
  626. package/skills/github/assets/rest-api/actions-variables.md +1247 -0
  627. package/skills/github/assets/rest-api/actions-workflow-runs.md +1697 -0
  628. package/skills/github/assets/rest-api/actions-workflows.md +348 -0
  629. package/skills/github/assets/rest-api/authenticating.md +174 -0
  630. package/skills/github/assets/rest-api/branches.md +727 -0
  631. package/skills/github/assets/rest-api/checks-runs.md +1013 -0
  632. package/skills/github/assets/rest-api/checks-suites.md +1142 -0
  633. package/skills/github/assets/rest-api/code-scanning.md +2957 -0
  634. package/skills/github/assets/rest-api/collaborators.md +547 -0
  635. package/skills/github/assets/rest-api/commits.md +957 -0
  636. package/skills/github/assets/rest-api/dependabot-alerts.md +895 -0
  637. package/skills/github/assets/rest-api/orgs.md +1172 -0
  638. package/skills/github/assets/rest-api/overview.md +875 -0
  639. package/skills/github/assets/rest-api/pull-reviews.md +722 -0
  640. package/skills/github/assets/rest-api/pulls.md +1605 -0
  641. package/skills/github/assets/rest-api/quickstart.md +344 -0
  642. package/skills/github/assets/rest-api/releases.md +650 -0
  643. package/skills/github/assets/rest-api/repos.md +2957 -0
  644. package/skills/github/assets/rest-api/rules.md +1507 -0
  645. package/skills/github/assets/rest-api/secret-scanning.md +947 -0
  646. package/skills/github/assets/rest-api/teams.md +1690 -0
  647. package/skills/github/githubAction/SKILL.md +159 -0
  648. package/skills/github/githubAction/assets/README.md +38 -0
  649. package/skills/github/githubAction/assets/reference/contexts.md +918 -0
  650. package/skills/github/githubAction/assets/reference/dependency-caching.md +393 -0
  651. package/skills/github/githubAction/assets/reference/events-that-trigger-workflows.md +1348 -0
  652. package/skills/github/githubAction/assets/reference/expressions.md +441 -0
  653. package/skills/github/githubAction/assets/reference/metadata-syntax.md +803 -0
  654. package/skills/github/githubAction/assets/reference/variables.md +149 -0
  655. package/skills/github/githubAction/assets/reference/workflow-cancellation.md +22 -0
  656. package/skills/github/githubAction/assets/reference/workflow-commands.md +1056 -0
  657. package/skills/github/githubAction/assets/reference/workflow-syntax.md +1721 -0
  658. package/skills/github/githubAction/assets/rest-api/secrets.md +1272 -0
  659. package/skills/github/githubAction/assets/rest-api/workflow-runs.md +1697 -0
  660. package/skills/github/githubAction/assets/rest-api/workflows.md +348 -0
  661. package/skills/github/githubAction/assets/starter-workflows/automation/stale.yml +27 -0
  662. package/skills/github/githubAction/assets/starter-workflows/ci/blank.yml +36 -0
  663. package/skills/github/githubAction/assets/starter-workflows/ci/docker-image.yml +18 -0
  664. package/skills/github/githubAction/assets/starter-workflows/ci/go.yml +28 -0
  665. package/skills/github/githubAction/assets/starter-workflows/ci/maven.yml +35 -0
  666. package/skills/github/githubAction/assets/starter-workflows/ci/node.js.yml +31 -0
  667. package/skills/github/githubAction/assets/starter-workflows/ci/python-app.yml +39 -0
  668. package/skills/github/githubAction/assets/starter-workflows/ci/rust.yml +22 -0
  669. package/skills/github/githubAction/assets/starter-workflows/code-scanning/codeql.yml +97 -0
  670. package/skills/github/githubAction/evals/actionVerification.json +14 -0
  671. package/skills/github/githubAction/references/apiReference.md +3 -0
  672. package/skills/github/githubAction/references/workflowPatterns.md +81 -0
  673. package/skills/github/githubAction/scripts/validateWorkflowYaml.py +53 -0
  674. package/skills/github/githubQuality/SKILL.md +136 -0
  675. package/skills/github/githubQuality/assets/README.md +24 -0
  676. package/skills/github/githubQuality/assets/pull-requests/about-code-owners.md +178 -0
  677. package/skills/github/githubQuality/assets/pull-requests/about-merge-methods.md +48 -0
  678. package/skills/github/githubQuality/assets/pull-requests/creating-a-pull-request.md +170 -0
  679. package/skills/github/githubQuality/assets/pull-requests/giving-reviews.md +48 -0
  680. package/skills/github/githubQuality/assets/pull-requests/managing-a-merge-queue.md +134 -0
  681. package/skills/github/githubQuality/assets/pull-requests/merging-a-pull-request.md +101 -0
  682. package/skills/github/githubQuality/assets/pull-requests/resolving-reviews.md +59 -0
  683. package/skills/github/githubQuality/assets/pull-requests/status-checks.md +135 -0
  684. package/skills/github/githubQuality/assets/rest-api/checks-runs.md +1013 -0
  685. package/skills/github/githubQuality/assets/rest-api/checks-suites.md +1142 -0
  686. package/skills/github/githubQuality/assets/rest-api/commits.md +957 -0
  687. package/skills/github/githubQuality/assets/rest-api/pulls.md +1605 -0
  688. package/skills/github/githubQuality/assets/rest-api/reviews.md +722 -0
  689. package/skills/github/githubQuality/evals/qualityVerification.json +14 -0
  690. package/skills/github/githubQuality/references/apiReference.md +3 -0
  691. package/skills/github/githubQuality/references/codeownersExample.md +26 -0
  692. package/skills/github/githubQuality/references/prTemplate.md +20 -0
  693. package/skills/github/githubQuality/scripts/auditPrQuality.py +52 -0
  694. package/skills/github/githubSecurity/SKILL.md +170 -0
  695. package/skills/github/githubSecurity/assets/README.md +32 -0
  696. package/skills/github/githubSecurity/assets/code-scanning/code-scanning-alerts.md +133 -0
  697. package/skills/github/githubSecurity/assets/code-scanning/code-scanning.md +67 -0
  698. package/skills/github/githubSecurity/assets/code-scanning/codeql-code-scanning.md +79 -0
  699. package/skills/github/githubSecurity/assets/code-scanning/configure-code-scanning.md +121 -0
  700. package/skills/github/githubSecurity/assets/dependabot/about-the-dependabot-yml-file.md +74 -0
  701. package/skills/github/githubSecurity/assets/dependabot/dependabot-alerts.md +133 -0
  702. package/skills/github/githubSecurity/assets/dependabot/dependabot-security-updates.md +95 -0
  703. package/skills/github/githubSecurity/assets/dependabot/dependabot-version-updates.md +80 -0
  704. package/skills/github/githubSecurity/assets/rest-api/code-scanning.md +2957 -0
  705. package/skills/github/githubSecurity/assets/rest-api/dependabot-alerts.md +895 -0
  706. package/skills/github/githubSecurity/assets/rest-api/secret-scanning.md +947 -0
  707. package/skills/github/githubSecurity/assets/secret-scanning/enable-secret-scanning.md +59 -0
  708. package/skills/github/githubSecurity/assets/secret-scanning/secret-scanning.md +105 -0
  709. package/skills/github/githubSecurity/assets/security-advisories/github-advisory-database.md +148 -0
  710. package/skills/github/githubSecurity/evals/securityVerification.json +14 -0
  711. package/skills/github/githubSecurity/references/apiReference.md +3 -0
  712. package/skills/github/githubSecurity/references/codeqlAnalysis.yml +42 -0
  713. package/skills/github/githubSecurity/references/dependabotConfig.yml +27 -0
  714. package/skills/github/githubSecurity/scripts/auditRepoSecurity.py +47 -0
  715. package/skills/github/githubSetup/SKILL.md +137 -0
  716. package/skills/github/githubSetup/assets/README.md +40 -0
  717. package/skills/github/githubSetup/assets/branches/about-protected-branches.md +198 -0
  718. package/skills/github/githubSetup/assets/branches/changing-the-default-branch.md +49 -0
  719. package/skills/github/githubSetup/assets/branches/deleting-and-restoring-branches.md +44 -0
  720. package/skills/github/githubSetup/assets/branches/managing-a-branch-protection-rule.md +115 -0
  721. package/skills/github/githubSetup/assets/branches/renaming-a-branch.md +74 -0
  722. package/skills/github/githubSetup/assets/branches/viewing-branches-in-your-repository.md +30 -0
  723. package/skills/github/githubSetup/assets/repositories/about-repositories.md +127 -0
  724. package/skills/github/githubSetup/assets/repositories/cloning-a-repository.md +114 -0
  725. package/skills/github/githubSetup/assets/repositories/creating-a-new-repository.md +82 -0
  726. package/skills/github/githubSetup/assets/repositories/creating-a-repository-from-a-template.md +51 -0
  727. package/skills/github/githubSetup/assets/repositories/deleting-a-repository.md +34 -0
  728. package/skills/github/githubSetup/assets/repositories/managing-teams-and-people-with-access.md +69 -0
  729. package/skills/github/githubSetup/assets/repositories/renaming-a-repository.md +47 -0
  730. package/skills/github/githubSetup/assets/repositories/restoring-a-deleted-repository.md +61 -0
  731. package/skills/github/githubSetup/assets/repositories/setting-repository-visibility.md +137 -0
  732. package/skills/github/githubSetup/assets/rest-api/branches.md +727 -0
  733. package/skills/github/githubSetup/assets/rest-api/quickstart.md +344 -0
  734. package/skills/github/githubSetup/assets/rest-api/repos.md +2957 -0
  735. package/skills/github/githubSetup/assets/rulesets/about-rulesets.md +72 -0
  736. package/skills/github/githubSetup/assets/rulesets/available-rules-for-rulesets.md +383 -0
  737. package/skills/github/githubSetup/assets/rulesets/converting-branch-protections-to-rulesets.md +92 -0
  738. package/skills/github/githubSetup/assets/rulesets/creating-rulesets-for-a-repository.md +108 -0
  739. package/skills/github/githubSetup/assets/rulesets/managing-rulesets-for-a-repository.md +149 -0
  740. package/skills/github/githubSetup/assets/rulesets/troubleshooting-rules.md +122 -0
  741. package/skills/github/githubSetup/evals/setupVerification.json +14 -0
  742. package/skills/github/githubSetup/references/apiReference.md +3 -0
  743. package/skills/github/githubSetup/references/repoSettingsBlueprint.md +13 -0
  744. package/skills/github/githubSetup/references/rulesetTemplates.json +42 -0
  745. package/skills/github/githubSetup/scripts/configureRepoBaseline.py +46 -0
  746. package/skills/github/githubTeam/SKILL.md +115 -0
  747. package/skills/github/githubTeam/assets/README.md +21 -0
  748. package/skills/github/githubTeam/assets/organizations/about-organizations.md +69 -0
  749. package/skills/github/githubTeam/assets/organizations/repository-roles-for-an-organization.md +94 -0
  750. package/skills/github/githubTeam/assets/rest-api/collaborators.md +547 -0
  751. package/skills/github/githubTeam/assets/rest-api/orgs.md +1172 -0
  752. package/skills/github/githubTeam/assets/rest-api/teams.md +1690 -0
  753. package/skills/github/githubTeam/assets/teams/about-teams.md +82 -0
  754. package/skills/github/githubTeam/assets/teams/adding-members-to-a-team.md +55 -0
  755. package/skills/github/githubTeam/evals/teamVerification.json +14 -0
  756. package/skills/github/githubTeam/references/apiReference.md +3 -0
  757. package/skills/github/githubTeam/references/permissionMatrix.md +17 -0
  758. package/skills/github/githubTeam/references/reviewAssignment.md +17 -0
  759. package/skills/github/githubTeam/scripts/manageTeamSync.py +31 -0
  760. package/skills/securityQa/llmSecurityRedteaming/SKILL.md +86 -0
  761. package/skills/securityQa/llmSecurityRedteaming/evals/securityRedteamVerification.json +14 -0
  762. package/skills/securityQa/llmSecurityRedteaming/references/apiReference.md +3 -0
  763. package/skills/securityQa/llmSecurityRedteaming/references/jailbreakTaxonomy.md +6 -0
  764. package/skills/securityQa/llmSecurityRedteaming/references/owaspLlmTopTen.md +12 -0
  765. package/skills/securityQa/llmSecurityRedteaming/scripts/testPromptInjection.py +34 -0
  766. package/skills/softwareDevelopment/requirementsEngineering/SKILL.md +110 -0
  767. package/skills/softwareDevelopment/requirementsEngineering/evals/evalRequirements.py +33 -0
  768. package/skills/softwareDevelopment/requirementsEngineering/references/apiReference.md +3 -0
  769. package/skills/softwareDevelopment/requirementsEngineering/references/requirementsAnalysisModels.md +34 -0
  770. package/skills/softwareDevelopment/requirementsEngineering/scripts/validateUserStories.py +49 -0
  771. package/skills/testing/testDrivenDevelopment/SKILL.md +122 -0
  772. package/skills/testing/testDrivenDevelopment/evals/evalTdd.py +25 -0
  773. package/skills/testing/testDrivenDevelopment/references/apiReference.md +3 -0
  774. package/skills/testing/testDrivenDevelopment/references/testPyramidDoubles.md +35 -0
  775. package/skills/testing/testDrivenDevelopment/scripts/auditTestPyramid.py +58 -0
@@ -0,0 +1,2363 @@
1
+
2
+ # gh reference
3
+
4
+ ## gh agent-task <command>
5
+
6
+ Work with agent tasks (preview)
7
+
8
+ Aliases
9
+
10
+ gh agent-tasks, gh agent, gh agents
11
+
12
+ ### gh agent-task create [<task description>] [flags]
13
+
14
+ Create an agent task (preview)
15
+
16
+ -b, --base string Base branch for the pull request (use default branch if not provided)
17
+ -a, --custom-agent string Use a custom agent for the task. e.g., use 'my-agent' for the 'my-agent.md' agent
18
+ --follow Follow agent session logs
19
+ -F, --from-file file Read task description from file (use "-" to read from standard input)
20
+
21
+ ### gh agent-task list [flags]
22
+
23
+ List agent tasks (preview)
24
+
25
+ -q, --jq expression Filter JSON output using a jq expression
26
+ --json fields Output JSON with the specified fields
27
+ -L, --limit int Maximum number of agent tasks to fetch (default 30)
28
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
29
+ -w, --web Open agent tasks in the browser
30
+
31
+ ### gh agent-task view [<session-id> | <pr-number> | <pr-url> | <pr-branch>] [flags]
32
+
33
+ View an agent task session (preview)
34
+
35
+ --follow Follow agent session logs
36
+ -q, --jq expression Filter JSON output using a jq expression
37
+ --json fields Output JSON with the specified fields
38
+ --log Show agent session logs
39
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
40
+ -w, --web Open agent task in the browser
41
+
42
+ ## gh alias <command>
43
+
44
+ Create command shortcuts
45
+
46
+ ### gh alias delete {<alias> | --all} [flags]
47
+
48
+ Delete set aliases
49
+
50
+ --all Delete all aliases
51
+
52
+ ### gh alias import [<filename> | -] [flags]
53
+
54
+ Import aliases from a YAML file
55
+
56
+ --clobber Overwrite existing aliases of the same name
57
+
58
+ ### gh alias list
59
+
60
+ List your aliases
61
+
62
+ Aliases
63
+
64
+ gh alias ls
65
+
66
+ ### gh alias set <alias> <expansion> [flags]
67
+
68
+ Create a shortcut for a gh command
69
+
70
+ --clobber Overwrite existing aliases of the same name
71
+ -s, --shell Declare an alias to be passed through a shell interpreter
72
+
73
+ ## gh api <endpoint> [flags]
74
+
75
+ Make an authenticated GitHub API request
76
+
77
+ --allow-escape-sequences Allow printing terminal escape sequences
78
+ --cache duration Cache the response, e.g. "3600s", "60m", "1h"
79
+ -F, --field key=value Add a typed parameter in key=value format (use "@<path>" or "@-" to read value from file or stdin)
80
+ -H, --header key:value Add a HTTP request header in key:value format
81
+ --hostname string The GitHub hostname for the request (default "github.com")
82
+ -i, --include Include HTTP response status line and headers in the output
83
+ --input file The file to use as body for the HTTP request (use "-" to read from standard input)
84
+ -q, --jq string Query to select values from the response using jq syntax
85
+ -X, --method string The HTTP method for the request (default "GET")
86
+ --paginate Make additional HTTP requests to fetch all pages of results
87
+ -p, --preview strings Opt into GitHub API previews (names should omit '-preview')
88
+ -f, --raw-field key=value Add a string parameter in key=value format
89
+ --silent Do not print the response body
90
+ --slurp Use with "--paginate" to return an array of all pages of either JSON arrays or objects
91
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
92
+ --verbose Include full HTTP request and response in the output
93
+
94
+ ## gh attestation [subcommand]
95
+
96
+ Work with artifact attestations
97
+
98
+ Aliases
99
+
100
+ gh at
101
+
102
+ ### gh attestation download [<file-path> | oci://<image-uri>] [--owner | --repo] [flags]
103
+
104
+ Download an artifact's attestations for offline use
105
+
106
+ -d, --digest-alg string The algorithm used to compute a digest of the artifact: {sha256|sha512} (default "sha256")
107
+ --hostname string Configure host to use
108
+ -L, --limit int Maximum number of attestations to fetch (default 30)
109
+ -o, --owner string GitHub organization to scope attestation lookup by
110
+ --predicate-type string Filter attestations by provided predicate type
111
+ -R, --repo string Repository name in the format <owner>/<repo>
112
+
113
+ ### gh attestation trusted-root [--tuf-url <url> --tuf-root <file-path>] [--verify-only] [flags]
114
+
115
+ Output trusted_root.jsonl contents, likely for offline verification
116
+
117
+ --hostname string Configure host to use
118
+ --tuf-root string Path to the TUF root.json file on disk
119
+ --tuf-url string URL to the TUF repository mirror
120
+ --verify-only Don't output trusted_root.jsonl contents
121
+
122
+ ### gh attestation verify [<file-path> | oci://<image-uri>] [--owner | --repo] [flags]
123
+
124
+ Verify an artifact's integrity using attestations
125
+
126
+ -b, --bundle string Path to bundle on disk, either a single bundle in a JSON file or a JSON lines file with multiple bundles
127
+ --bundle-from-oci When verifying an OCI image, fetch the attestation bundle from the OCI registry instead of from GitHub
128
+ --cert-identity string Enforce that the certificate's SubjectAlternativeName matches the provided value exactly
129
+ -i, --cert-identity-regex string Enforce that the certificate's SubjectAlternativeName matches the provided regex
130
+ --cert-oidc-issuer string Enforce that the issuer of the OIDC token matches the provided value (default "https://token.actions.githubusercontent.com")
131
+ --custom-trusted-root string Path to a trusted_root.jsonl file; likely for offline verification
132
+ --deny-self-hosted-runners Fail verification for attestations generated on self-hosted runners
133
+ -d, --digest-alg string The algorithm used to compute a digest of the artifact: {sha256|sha512} (default "sha256")
134
+ --format string Output format: {json}
135
+ --hostname string Configure host to use
136
+ -q, --jq expression Filter JSON output using a jq expression
137
+ -L, --limit int Maximum number of attestations to fetch (default 30)
138
+ --no-public-good Do not verify attestations signed with Sigstore public good instance
139
+ -o, --owner string GitHub organization to scope attestation lookup by
140
+ --predicate-type string Enforce that verified attestations' predicate type matches the provided value (default "https://slsa.dev/provenance/v1")
141
+ -R, --repo string Repository name in the format <owner>/<repo>
142
+ --signer-digest string Enforce that the digest associated with the signer workflow matches the provided value
143
+ --signer-repo string Enforce that the workflow that signed the attestation's repository matches the provided value (<owner>/<repo>)
144
+ --signer-workflow string Enforce that the workflow that signed the attestation matches the provided value ([host/]<owner>/<repo>/<path>/<to>/<workflow>)
145
+ --source-digest string Enforce that the digest associated with the source repository matches the provided value
146
+ --source-ref string Enforce that the git ref associated with the source repository matches the provided value
147
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
148
+
149
+ ## gh auth <command>
150
+
151
+ Authenticate gh and git with GitHub
152
+
153
+ ### gh auth login [flags]
154
+
155
+ Log in to a GitHub account
156
+
157
+ -c, --clipboard Copy one-time OAuth device code to clipboard
158
+ --expiring Prefer expiring credentials that gh refreshes automatically, if the host supports them
159
+ -p, --git-protocol string The protocol to use for git operations on this host: {ssh|https}
160
+ -h, --hostname string The hostname of the GitHub instance to authenticate with
161
+ --insecure-storage Save authentication credentials in plain text instead of credential store
162
+ -s, --scopes strings Additional authentication scopes to request
163
+ --skip-ssh-key Skip generate/upload SSH key prompt
164
+ -w, --web Open a browser to authenticate
165
+ --with-token Read token from standard input
166
+
167
+ ### gh auth logout [flags]
168
+
169
+ Log out of a GitHub account
170
+
171
+ -h, --hostname string The hostname of the GitHub instance to log out of
172
+ -u, --user string The account to log out of
173
+
174
+ ### gh auth refresh [flags]
175
+
176
+ Refresh stored authentication credentials
177
+
178
+ -c, --clipboard Copy one-time OAuth device code to clipboard
179
+ --expiring Prefer expiring credentials that gh refreshes automatically, if the host supports them
180
+ -h, --hostname string The GitHub host to use for authentication
181
+ --insecure-storage Save authentication credentials in plain text instead of credential store
182
+ -r, --remove-scopes strings Authentication scopes to remove from gh
183
+ --reset-scopes Reset authentication scopes to the default minimum set of scopes
184
+ -s, --scopes strings Additional authentication scopes for gh to have
185
+
186
+ ### gh auth setup-git [flags]
187
+
188
+ Setup git with GitHub CLI
189
+
190
+ -f, --force --hostname Force setup even if the host is not known. Must be used in conjunction with --hostname
191
+ -h, --hostname string The hostname to configure git for
192
+
193
+ ### gh auth status [flags]
194
+
195
+ Display active account and authentication state on each known GitHub host
196
+
197
+ -a, --active Display the active account only
198
+ -h, --hostname string Check only a specific hostname's auth status
199
+ --jq expression Filter JSON output using a jq expression
200
+ --json fields Output JSON with the specified fields
201
+ --no-refresh Do not automatically refresh expired tokens
202
+ -t, --show-token Display the auth token
203
+ --template string Format JSON output using a Go template; see "gh help formatting"
204
+
205
+ ### gh auth switch [flags]
206
+
207
+ Switch active GitHub account
208
+
209
+ -h, --hostname string The hostname of the GitHub instance to switch account for
210
+ -u, --user string The account to switch to
211
+
212
+ ### gh auth token [flags]
213
+
214
+ Print the authentication token gh uses for a hostname and account
215
+
216
+ -h, --hostname string The hostname of the GitHub instance authenticated with
217
+ --no-refresh Do not automatically refresh an expired token
218
+ -u, --user string The account to output the token for
219
+
220
+ ## gh browse [<number> | <path> | <commit-sha>] [flags]
221
+
222
+ Open repositories, issues, pull requests, and more in the browser
223
+
224
+ -a, --actions Open repository actions
225
+ --blame Open blame view for a file
226
+ -b, --branch string Select another branch by passing in the branch name
227
+ -c, --commit string[="last"] Select another commit by passing in the commit SHA, default is the last commit
228
+ -n, --no-browser Print destination URL instead of opening the browser
229
+ -p, --projects Open repository projects
230
+ -r, --releases Open repository releases
231
+ -s, --settings Open repository settings
232
+ -w, --wiki Open repository wiki
233
+
234
+ ## gh cache <command>
235
+
236
+ Manage GitHub Actions caches
237
+
238
+ ### gh cache delete [<cache-id> | <cache-key> | --all] [flags]
239
+
240
+ Delete GitHub Actions caches
241
+
242
+ -a, --all Delete all caches, can be used with --ref to delete all caches for a specific ref
243
+ -r, --ref string Delete by cache key and ref, formatted as refs/heads/<branch name> or refs/pull/<number>/merge
244
+ --succeed-on-no-caches --all Return exit code 0 if no caches found. Must be used in conjunction with --all
245
+
246
+ ### gh cache list [flags]
247
+
248
+ List GitHub Actions caches
249
+
250
+ -q, --jq expression Filter JSON output using a jq expression
251
+ --json fields Output JSON with the specified fields
252
+ -k, --key string Filter by cache key prefix
253
+ -L, --limit int Maximum number of caches to fetch (default 30)
254
+ -O, --order string Order of caches returned: {asc|desc} (default "desc")
255
+ -r, --ref string Filter by ref, formatted as refs/heads/<branch name> or refs/pull/<number>/merge
256
+ -S, --sort string Sort fetched caches: {created_at|last_accessed_at|size_in_bytes} (default "last_accessed_at")
257
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
258
+
259
+ Aliases
260
+
261
+ gh cache ls
262
+
263
+ ## gh co
264
+
265
+ Alias for "pr checkout"
266
+
267
+ ## gh codespace
268
+
269
+ Connect to and manage codespaces
270
+
271
+ Aliases
272
+
273
+ gh cs
274
+
275
+ ### gh codespace code [flags]
276
+
277
+ Open a codespace in Visual Studio Code
278
+
279
+ -c, --codespace string Name of the codespace
280
+ --insiders Use the insiders version of Visual Studio Code
281
+ -R, --repo string Filter codespace selection by repository name (user/repo)
282
+ --repo-owner string Filter codespace selection by repository owner (username or org)
283
+ -w, --web Use the web version of Visual Studio Code
284
+
285
+ ### gh codespace cp [-e] [-r] [-- [<scp flags>...]] <sources>... <dest>
286
+
287
+ Copy files between local and remote file systems
288
+
289
+ -c, --codespace string Name of the codespace
290
+ -e, --expand Expand remote file names on remote shell
291
+ -p, --profile string Name of the SSH profile to use
292
+ -r, --recursive Recursively copy directories
293
+ -R, --repo string Filter codespace selection by repository name (user/repo)
294
+ --repo-owner string Filter codespace selection by repository owner (username or org)
295
+
296
+ ### gh codespace create [flags]
297
+
298
+ Create a codespace
299
+
300
+ -b, --branch string Repository branch
301
+ --default-permissions Do not prompt to accept additional permissions requested by the codespace
302
+ --devcontainer-path string Path to the devcontainer.json file to use when creating codespace
303
+ -d, --display-name string Display name for the codespace (48 characters or less)
304
+ --idle-timeout duration Allowed inactivity before codespace is stopped, e.g. "10m", "1h"
305
+ -l, --location string Location: {EastUs|SouthEastAsia|WestEurope|WestUs2} (determined automatically if not provided)
306
+ -m, --machine string Hardware specifications for the VM
307
+ -R, --repo string Repository name with owner: user/repo
308
+ --retention-period duration Allowed time after shutting down before the codespace is automatically deleted (maximum 30 days), e.g. "1h", "72h"
309
+ -s, --status Show status of post-create command and dotfiles
310
+ -w, --web Create codespace from browser, cannot be used with --display-name, --idle-timeout, or --retention-period
311
+
312
+ ### gh codespace delete [flags]
313
+
314
+ Delete codespaces
315
+
316
+ --all Delete all codespaces
317
+ -c, --codespace string Name of the codespace
318
+ --days N Delete codespaces older than N days
319
+ -f, --force Skip confirmation for codespaces that contain unsaved changes
320
+ -o, --org login The login handle of the organization (admin-only)
321
+ -R, --repo string Filter codespace selection by repository name (user/repo)
322
+ --repo-owner string Filter codespace selection by repository owner (username or org)
323
+ -u, --user username The username to delete codespaces for (used with --org)
324
+
325
+ ### gh codespace edit [flags]
326
+
327
+ Edit a codespace
328
+
329
+ -c, --codespace string Name of the codespace
330
+ -d, --display-name string Set the display name
331
+ -m, --machine string Set hardware specifications for the VM
332
+ -R, --repo string Filter codespace selection by repository name (user/repo)
333
+ --repo-owner string Filter codespace selection by repository owner (username or org)
334
+
335
+ ### gh codespace jupyter [flags]
336
+
337
+ Open a codespace in JupyterLab
338
+
339
+ -c, --codespace string Name of the codespace
340
+ -R, --repo string Filter codespace selection by repository name (user/repo)
341
+ --repo-owner string Filter codespace selection by repository owner (username or org)
342
+
343
+ ### gh codespace list [flags]
344
+
345
+ List codespaces
346
+
347
+ -q, --jq expression Filter JSON output using a jq expression
348
+ --json fields Output JSON with the specified fields
349
+ -L, --limit int Maximum number of codespaces to list (default 30)
350
+ -o, --org login The login handle of the organization to list codespaces for (admin-only)
351
+ -R, --repo string Repository name with owner: user/repo
352
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
353
+ -u, --user username The username to list codespaces for (used with --org)
354
+ -w, --web List codespaces in the web browser, cannot be used with --user or --org
355
+
356
+ Aliases
357
+
358
+ gh codespace ls, gh cs ls
359
+
360
+ ### gh codespace logs [flags]
361
+
362
+ Access codespace logs
363
+
364
+ -c, --codespace string Name of the codespace
365
+ -f, --follow Tail and follow the logs
366
+ -R, --repo string Filter codespace selection by repository name (user/repo)
367
+ --repo-owner string Filter codespace selection by repository owner (username or org)
368
+
369
+ ### gh codespace ports [flags]
370
+
371
+ List ports in a codespace
372
+
373
+ -c, --codespace string Name of the codespace
374
+ -q, --jq expression Filter JSON output using a jq expression
375
+ --json fields Output JSON with the specified fields
376
+ -R, --repo string Filter codespace selection by repository name (user/repo)
377
+ --repo-owner string Filter codespace selection by repository owner (username or org)
378
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
379
+
380
+ #### gh codespace ports forward <remote-port>:<local-port>... [flags]
381
+
382
+ Forward ports
383
+
384
+ --all-interfaces Listen on all network interfaces
385
+
386
+ #### gh codespace ports visibility <port>:{public|private|org}...
387
+
388
+ Change the visibility of the forwarded port
389
+
390
+ ### gh codespace rebuild [flags]
391
+
392
+ Rebuild a codespace
393
+
394
+ -c, --codespace string Name of the codespace
395
+ --full Perform a full rebuild
396
+ -R, --repo string Filter codespace selection by repository name (user/repo)
397
+ --repo-owner string Filter codespace selection by repository owner (username or org)
398
+
399
+ ### gh codespace ssh [<flags>...] [-- <ssh-flags>...] [<command>]
400
+
401
+ SSH into a codespace
402
+
403
+ -c, --codespace string Name of the codespace
404
+ --config Write OpenSSH configuration to stdout
405
+ -d, --debug Log debug data to a file
406
+ --debug-file string Path of the file log to
407
+ --profile string Name of the SSH profile to use
408
+ -R, --repo string Filter codespace selection by repository name (user/repo)
409
+ --repo-owner string Filter codespace selection by repository owner (username or org)
410
+ --server-port int SSH server port number (0 => pick unused)
411
+
412
+ ### gh codespace stop [flags]
413
+
414
+ Stop a running codespace
415
+
416
+ -c, --codespace string Name of the codespace
417
+ -o, --org login The login handle of the organization (admin-only)
418
+ -R, --repo string Filter codespace selection by repository name (user/repo)
419
+ --repo-owner string Filter codespace selection by repository owner (username or org)
420
+ -u, --user username The username to stop codespace for (used with --org)
421
+
422
+ ### gh codespace view [flags]
423
+
424
+ View details about a codespace
425
+
426
+ -c, --codespace string Name of the codespace
427
+ -q, --jq expression Filter JSON output using a jq expression
428
+ --json fields Output JSON with the specified fields
429
+ -R, --repo string Filter codespace selection by repository name (user/repo)
430
+ --repo-owner string Filter codespace selection by repository owner (username or org)
431
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
432
+
433
+ ## gh completion -s <shell>
434
+
435
+ Generate shell completion scripts
436
+
437
+ -s, --shell string Shell type: {bash|zsh|fish|powershell}
438
+
439
+ ## gh config <command>
440
+
441
+ Manage configuration for gh
442
+
443
+ ### gh config clear-cache
444
+
445
+ Clear the cli cache
446
+
447
+ ### gh config get <key> [flags]
448
+
449
+ Print the value of a given configuration key
450
+
451
+ -h, --host string Get per-host setting
452
+
453
+ ### gh config list [flags]
454
+
455
+ Print a list of configuration keys and values
456
+
457
+ -h, --host string Get per-host configuration
458
+
459
+ Aliases
460
+
461
+ gh config ls
462
+
463
+ ### gh config set <key> <value> [flags]
464
+
465
+ Update configuration with a value for the given key
466
+
467
+ -h, --host string Set per-host setting
468
+
469
+ ## gh copilot [flags] [args]
470
+
471
+ Run the GitHub Copilot CLI (preview)
472
+
473
+ --remove Remove the downloaded Copilot CLI
474
+
475
+ ## gh discussion <command>
476
+
477
+ Work with GitHub Discussions (preview)
478
+
479
+ ### gh discussion comment {<number> | <discussion-url> | <comment-id> | <comment-url>} [flags]
480
+
481
+ Add, edit, or delete a comment or a reply on a discussion (preview)
482
+
483
+ -b, --body string Comment body text
484
+ -F, --body-file string Read body text from file (use "-" to read from standard input)
485
+ --delete Delete the specified comment
486
+ --edit Edit the specified comment
487
+ --yes Skip the delete confirmation prompt
488
+
489
+ ### gh discussion create [flags]
490
+
491
+ Create a new discussion (preview)
492
+
493
+ -b, --body string Body for the discussion
494
+ -F, --body-file string Read body text from file (use "-" to read from stdin)
495
+ -c, --category string Category name or slug for the discussion
496
+ -l, --label strings Labels to apply to the discussion
497
+ -t, --title string Title for the discussion
498
+
499
+ ### gh discussion edit {<number> | <discussion-url>} [flags]
500
+
501
+ Edit a discussion (preview)
502
+
503
+ --add-label name Add labels by name
504
+ -b, --body string New body for the discussion
505
+ -F, --body-file string Read body text from file (use "-" to read from standard input)
506
+ -c, --category string New category name or slug for the discussion
507
+ --remove-label name Remove labels by name
508
+ -t, --title string New title for the discussion
509
+
510
+ ### gh discussion list [flags]
511
+
512
+ List discussions in a repository (preview)
513
+
514
+ --after string Cursor for the next page of results
515
+ --answered Filter by answered state
516
+ -A, --author string Filter by author
517
+ -c, --category string Filter by category name or slug
518
+ -q, --jq expression Filter JSON output using a jq expression
519
+ --json fields Output JSON with the specified fields
520
+ -l, --label strings Filter by label
521
+ -L, --limit int Maximum number of discussions to fetch (default 30)
522
+ --order string Order of results: {asc|desc} (default "desc")
523
+ -S, --search query Search discussions with query
524
+ --sort string Sort by field: {created|updated} (default "updated")
525
+ -s, --state string Filter by state: {open|closed|all} (default "open")
526
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
527
+ -w, --web List discussions in the web browser
528
+
529
+ Aliases
530
+
531
+ gh discussion ls
532
+
533
+ ### gh discussion view {<number> | <discussion-url> | <comment-id> | <comment-url>} [flags]
534
+
535
+ View a discussion (preview)
536
+
537
+ --after string Cursor for the next page
538
+ -c, --comments View discussion comments
539
+ -q, --jq expression Filter JSON output using a jq expression
540
+ --json fields Output JSON with the specified fields
541
+ -L, --limit int Maximum number of comments or replies to fetch (default 30)
542
+ --order string Order of comments or replies: {oldest|newest} (default "newest")
543
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
544
+ -w, --web Open a discussion in the browser
545
+
546
+ ## gh extension
547
+
548
+ Manage gh extensions
549
+
550
+ Aliases
551
+
552
+ gh extensions, gh ext
553
+
554
+ ### gh extension browse [flags]
555
+
556
+ Enter a UI for browsing, adding, and removing extensions
557
+
558
+ --debug Log to /tmp/extBrowse-*
559
+ -s, --single-column Render TUI with only one column of text
560
+
561
+ ### gh extension create [<name>] [flags]
562
+
563
+ Create a new extension
564
+
565
+ --precompiled string Create a precompiled extension. Possible values: go, other
566
+
567
+ ### gh extension exec <name> [args]
568
+
569
+ Execute an installed extension
570
+
571
+ ### gh extension install <repository> [flags]
572
+
573
+ Install a gh extension from a repository
574
+
575
+ --force Force upgrade extension, or ignore if latest already installed
576
+ --pin string Pin extension to a release tag or commit ref
577
+
578
+ ### gh extension list
579
+
580
+ List installed extension commands
581
+
582
+ Aliases
583
+
584
+ gh ext ls, gh extension ls, gh extensions ls
585
+
586
+ ### gh extension remove <name>
587
+
588
+ Remove an installed extension
589
+
590
+ Aliases
591
+
592
+ gh ext uninstall, gh extension uninstall, gh extensions uninstall
593
+
594
+ ### gh extension search [<query>] [flags]
595
+
596
+ Search extensions to the GitHub CLI
597
+
598
+ -q, --jq expression Filter JSON output using a jq expression
599
+ --json fields Output JSON with the specified fields
600
+ --license strings Filter based on license type
601
+ -L, --limit int Maximum number of extensions to fetch (default 30)
602
+ --order string Order of repositories returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
603
+ --owner strings Filter on owner
604
+ --sort string Sort fetched repositories: {forks|help-wanted-issues|stars|updated} (default "best-match")
605
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
606
+ -w, --web Open the search query in the web browser
607
+
608
+ ### gh extension upgrade {<name> | --all} [flags]
609
+
610
+ Upgrade installed extensions
611
+
612
+ --all Upgrade all extensions
613
+ --dry-run Only display upgrades
614
+ --force Force upgrade extension
615
+
616
+ ## gh gist <command>
617
+
618
+ Manage gists
619
+
620
+ ### gh gist clone <gist> [<directory>] [-- <gitflags>...]
621
+
622
+ Clone a gist locally
623
+
624
+ ### gh gist create [<filename>... | <pattern>... | -] [flags]
625
+
626
+ Create a new gist
627
+
628
+ -d, --desc string A description for this gist
629
+ -f, --filename string Provide a filename to be used when reading from standard input
630
+ -p, --public List the gist publicly (default "secret")
631
+ -w, --web Open the web browser with created gist
632
+
633
+ Aliases
634
+
635
+ gh gist new
636
+
637
+ ### gh gist delete {<id> | <url>} [flags]
638
+
639
+ Delete a gist
640
+
641
+ --yes Confirm deletion without prompting
642
+
643
+ ### gh gist edit {<id> | <url>} [<filename>] [flags]
644
+
645
+ Edit one of your gists
646
+
647
+ -a, --add string Add a new file to the gist
648
+ -d, --desc string New description for the gist
649
+ -f, --filename string Select a file to edit
650
+ -r, --remove string Remove a file from the gist
651
+
652
+ ### gh gist list [flags]
653
+
654
+ List your gists
655
+
656
+ --filter expression Filter gists using a regular expression
657
+ --include-content Include gists' file content when filtering
658
+ -L, --limit int Maximum number of gists to fetch (default 10)
659
+ --public Show only public gists
660
+ --secret Show only secret gists
661
+
662
+ Aliases
663
+
664
+ gh gist ls
665
+
666
+ ### gh gist rename {<id> | <url>} <old-filename> <new-filename>
667
+
668
+ Rename a file in a gist
669
+
670
+ ### gh gist view [<id> | <url>] [flags]
671
+
672
+ View a gist
673
+
674
+ --allow-escape-sequences Allow printing terminal escape sequences
675
+ -f, --filename string Display a single file from the gist
676
+ --files List file names from the gist
677
+ -r, --raw Print raw instead of rendered gist contents
678
+ -w, --web Open gist in the browser
679
+
680
+ ## gh gpg-key <command>
681
+
682
+ Manage GPG keys
683
+
684
+ ### gh gpg-key add [<key-file>] [flags]
685
+
686
+ Add a GPG key to your GitHub account
687
+
688
+ -t, --title string Title for the new key
689
+
690
+ ### gh gpg-key delete <key-id> [flags]
691
+
692
+ Delete a GPG key from your GitHub account
693
+
694
+ -y, --yes Skip the confirmation prompt
695
+
696
+ ### gh gpg-key list
697
+
698
+ Lists GPG keys in your GitHub account
699
+
700
+ Aliases
701
+
702
+ gh gpg-key ls
703
+
704
+ ## gh issue <command>
705
+
706
+ Manage issues
707
+
708
+ ### gh issue artifact <command>
709
+
710
+ Work with issue artifacts (preview)
711
+
712
+ #### gh issue artifact create {<issue-number> | <issue-url>} [<file>[#<name>] | <url>]... [flags]
713
+
714
+ Create issue artifacts (preview)
715
+
716
+ --attach file Attach an image or video file, in '<file>#<image alt text>' format
717
+ -b, --body string Content for a single document
718
+ -F, --body-file file Read content for a single artifact from file (use "-" to read from standard input)
719
+ --name string Name for a single artifact
720
+ --type string Type for documents: {generic|plan|embedded_html}
721
+
722
+ Aliases
723
+
724
+ gh issue artifact new
725
+
726
+ #### gh issue artifact delete {<issue> <artifact-number>... | <artifact-url>...} [flags]
727
+
728
+ Delete issue artifacts (preview)
729
+
730
+ --yes Confirm deletion without prompting
731
+
732
+ #### gh issue artifact download {<issue> [<artifact-number>...] | <artifact-url>...} [flags]
733
+
734
+ Download issue artifacts (preview)
735
+
736
+ --clobber Overwrite existing files of the same name
737
+ -D, --dir directory The directory to download files into (default ".")
738
+ -O, --output file The file to write a single artifact to (use "-" to write to standard output)
739
+ --skip-existing Skip downloading when files of the same name exist
740
+ --version number Download the version with this number from the edit history
741
+
742
+ #### gh issue artifact edit {<issue> <artifact-number> | <artifact-url>} [flags]
743
+
744
+ Edit an issue artifact (preview)
745
+
746
+ --attach file Attach an image or video file, in '<file>#<image alt text>' format
747
+ -b, --body string New content; for a link, a URL
748
+ -F, --body-file file Read new content from file (use "-" to read from standard input)
749
+ --name string New name
750
+ --restore-version number Restore the version with this number from the edit history
751
+
752
+ #### gh issue artifact list {<issue-number> | <issue-url>} [flags]
753
+
754
+ List artifacts on an issue (preview)
755
+
756
+ -q, --jq expression Filter JSON output using a jq expression
757
+ --json fields Output JSON with the specified fields
758
+ -L, --limit int Maximum number of artifacts to fetch
759
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
760
+ --type string Filter by type: {generic|plan|link|embedded_html}
761
+
762
+ Aliases
763
+
764
+ gh issue artifact ls
765
+
766
+ #### gh issue artifact view {<issue> <artifact-number> | <artifact-url>} [flags]
767
+
768
+ View an issue artifact (preview)
769
+
770
+ -q, --jq expression Filter JSON output using a jq expression
771
+ --json fields Output JSON with the specified fields
772
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
773
+ --version number Show the version with this number from the edit history
774
+ -w, --web Open a document's page on GitHub, or a link's URL
775
+
776
+ ### gh issue close {<number> | <url>} [flags]
777
+
778
+ Close issue
779
+
780
+ -c, --comment string Leave a closing comment
781
+ --duplicate-of string Mark as duplicate of another issue by number or URL
782
+ -r, --reason string Reason for closing: {completed|not planned|duplicate}
783
+
784
+ ### gh issue comment {<number> | <url>} [flags]
785
+
786
+ Add a comment to an issue
787
+
788
+ --attach file Attach an image or video file, in '<file>#<image alt text>' format
789
+ -b, --body text The comment body text
790
+ -F, --body-file file Read body text from file (use "-" to read from standard input)
791
+ --create-if-none Create a new comment if no comments are found. Can be used only with --edit-last
792
+ --delete-last Delete the last comment of the current user
793
+ --edit-last Edit the last comment of the current user
794
+ -e, --editor Skip prompts and open the text editor to write the body in
795
+ -w, --web Open the web browser to write the comment
796
+ --yes Skip the delete confirmation prompt when --delete-last is provided
797
+
798
+ ### gh issue create [flags]
799
+
800
+ Create a new issue
801
+
802
+ -a, --assignee login Assign people by their login. Use "@me" to self-assign.
803
+ --attach file Attach an image or video file, in '<file>#<image alt text>' format
804
+ --blocked-by numbers Mark the new issue as blocked by these issue numbers or URLs
805
+ --blocking numbers Mark the new issue as blocking these issue numbers or URLs
806
+ -b, --body string Supply a body. Will prompt for one otherwise.
807
+ -F, --body-file file Read body text from file (use "-" to read from standard input)
808
+ -e, --editor Skip prompts and open the text editor to write the title and body in. The first line is the title and the remaining text is the body.
809
+ -l, --label name Add labels by name
810
+ -m, --milestone name Add the issue to a milestone by name
811
+ --parent number Add the new issue as a sub-issue of the specified parent number or URL
812
+ -p, --project title Add the issue to projects by title
813
+ --recover string Recover input from a failed run of create
814
+ -T, --template name Template name to use as starting body text
815
+ -t, --title string Supply a title. Will prompt for one otherwise.
816
+ --type name Set the issue type by name
817
+ -w, --web Open the browser to create an issue
818
+
819
+ Aliases
820
+
821
+ gh issue new
822
+
823
+ ### gh issue delete {<number> | <url>} [flags]
824
+
825
+ Delete issue
826
+
827
+ --yes Confirm deletion without prompting
828
+
829
+ ### gh issue develop {<number> | <url>} [flags]
830
+
831
+ Manage linked branches for an issue
832
+
833
+ -b, --base string Name of the remote branch you want to make your new branch from
834
+ --branch-repo string Name or URL of the repository where you want to create your new branch
835
+ -c, --checkout Checkout the branch after creating it
836
+ -l, --list List linked branches for the issue
837
+ -n, --name string Name of the branch to create
838
+ --worktree path Check out the branch into a worktree at the given path
839
+
840
+ ### gh issue edit {<numbers> | <urls>} [flags]
841
+
842
+ Edit issues
843
+
844
+ --add-assignee login Add assigned users by their login. Use "@me" to assign yourself, or "@copilot" to assign Copilot.
845
+ --add-blocked-by number Add 'blocked by' relationships by issue number or URL
846
+ --add-blocking number Add 'blocking' relationships by issue number or URL
847
+ --add-label name Add labels by name
848
+ --add-project title Add the issue to projects by title
849
+ --add-sub-issue number Add sub-issues by number or URL
850
+ --attach file Attach an image or video file, in '<file>#<image alt text>' format
851
+ -b, --body string Set the new body.
852
+ -F, --body-file file Read body text from file (use "-" to read from standard input)
853
+ -m, --milestone name Edit the milestone the issue belongs to by name
854
+ --parent number Set the parent issue by number or URL
855
+ --remove-assignee login Remove assigned users by their login. Use "@me" to unassign yourself, or "@copilot" to unassign Copilot.
856
+ --remove-blocked-by number Remove 'blocked by' relationships by issue number or URL
857
+ --remove-blocking number Remove 'blocking' relationships by issue number or URL
858
+ --remove-label name Remove labels by name
859
+ --remove-milestone Remove the milestone association from the issue
860
+ --remove-parent Remove the parent issue
861
+ --remove-project title Remove the issue from projects by title
862
+ --remove-sub-issue number Remove sub-issues by number or URL
863
+ --remove-type Remove the issue type from the issue
864
+ -t, --title string Set the new title.
865
+ --type name Set the issue type by name
866
+
867
+ ### gh issue list [flags]
868
+
869
+ List issues in a repository
870
+
871
+ --app string Filter by GitHub App author
872
+ -a, --assignee string Filter by assignee
873
+ -A, --author string Filter by author (use --app to filter by a GitHub App)
874
+ -q, --jq expression Filter JSON output using a jq expression
875
+ --json fields Output JSON with the specified fields
876
+ -l, --label strings Filter by label
877
+ -L, --limit int Maximum number of issues to fetch (default 30)
878
+ --mention string Filter by mention
879
+ -m, --milestone string Filter by milestone number or title
880
+ -S, --search query Search issues with query
881
+ -s, --state string Filter by state: {open|closed|all} (default "open")
882
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
883
+ --type name Filter by issue type name
884
+ -w, --web List issues in the web browser
885
+
886
+ Aliases
887
+
888
+ gh issue ls
889
+
890
+ ### gh issue lock {<number> | <url>} [flags]
891
+
892
+ Lock issue conversation
893
+
894
+ -r, --reason string Optional reason for locking conversation (off_topic, resolved, spam, too_heated).
895
+
896
+ ### gh issue pin {<number> | <url>}
897
+
898
+ Pin an issue
899
+
900
+ ### gh issue reopen {<number> | <url>} [flags]
901
+
902
+ Reopen issue
903
+
904
+ -c, --comment string Add a reopening comment
905
+
906
+ ### gh issue status [flags]
907
+
908
+ Show status of relevant issues
909
+
910
+ -q, --jq expression Filter JSON output using a jq expression
911
+ --json fields Output JSON with the specified fields
912
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
913
+
914
+ ### gh issue transfer {<number> | <url>} <destination-repo>
915
+
916
+ Transfer issue to another repository
917
+
918
+ ### gh issue unlock {<number> | <url>}
919
+
920
+ Unlock issue conversation
921
+
922
+ ### gh issue unpin {<number> | <url>}
923
+
924
+ Unpin an issue
925
+
926
+ ### gh issue view {<number> | <url>} [flags]
927
+
928
+ View an issue
929
+
930
+ -c, --comments View issue comments
931
+ -q, --jq expression Filter JSON output using a jq expression
932
+ --json fields Output JSON with the specified fields
933
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
934
+ -w, --web Open an issue in the browser
935
+
936
+ ## gh label <command>
937
+
938
+ Manage labels
939
+
940
+ ### gh label clone <source-repository> [flags]
941
+
942
+ Clones labels from one repository to another
943
+
944
+ -f, --force Overwrite labels in the destination repository
945
+
946
+ ### gh label create <name> [flags]
947
+
948
+ Create a new label
949
+
950
+ -c, --color string Color of the label
951
+ -d, --description string Description of the label
952
+ -f, --force Update the label color and description if label already exists
953
+
954
+ ### gh label delete <name> [flags]
955
+
956
+ Delete a label from a repository
957
+
958
+ --yes Confirm deletion without prompting
959
+
960
+ ### gh label edit <name> [flags]
961
+
962
+ Edit a label
963
+
964
+ -c, --color string Color of the label
965
+ -d, --description string Description of the label
966
+ -n, --name string New name of the label
967
+
968
+ ### gh label list [flags]
969
+
970
+ List labels in a repository
971
+
972
+ -q, --jq expression Filter JSON output using a jq expression
973
+ --json fields Output JSON with the specified fields
974
+ -L, --limit int Maximum number of labels to fetch (default 30)
975
+ --order string Order of labels returned: {asc|desc} (default "asc")
976
+ -S, --search string Search label names and descriptions
977
+ --sort string Sort fetched labels: {created|name} (default "created")
978
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
979
+ -w, --web List labels in the web browser
980
+
981
+ Aliases
982
+
983
+ gh label ls
984
+
985
+ ## gh licenses
986
+
987
+ View third-party license information
988
+
989
+ ## gh org <command>
990
+
991
+ Manage organizations
992
+
993
+ ### gh org list [flags]
994
+
995
+ List organizations for the authenticated user.
996
+
997
+ -L, --limit int Maximum number of organizations to list (default 30)
998
+
999
+ Aliases
1000
+
1001
+ gh org ls
1002
+
1003
+ ## gh pr <command> [flags]
1004
+
1005
+ Manage pull requests
1006
+
1007
+ --help Show help for command
1008
+ -R, --repo [HOST/]OWNER/REPO Select another repository using the [HOST/]OWNER/REPO format
1009
+
1010
+ ### gh pr checkout [<number> | <url> | <branch>] [flags]
1011
+
1012
+ Check out a pull request in git
1013
+
1014
+ -b, --branch string Local branch name to use (default [the name of the head branch])
1015
+ --detach Checkout PR with a detached HEAD
1016
+ -f, --force Reset the existing local branch to the latest state of the pull request
1017
+ --recurse-submodules Update all submodules after checkout
1018
+ --worktree path Check out the pull request into a worktree at the given path
1019
+
1020
+ Aliases
1021
+
1022
+ gh pr co
1023
+
1024
+ ### gh pr checks [<number> | <url> | <branch>] [flags]
1025
+
1026
+ Show CI status for a single pull request
1027
+
1028
+ --fail-fast Exit watch mode on first check failure
1029
+ -i, --interval int Refresh interval in seconds in watch mode (default 10)
1030
+ -q, --jq expression Filter JSON output using a jq expression
1031
+ --json fields Output JSON with the specified fields
1032
+ --required Only show checks that are required
1033
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1034
+ --watch Watch checks until they finish
1035
+ -w, --web Open the web browser to show details about checks
1036
+
1037
+ ### gh pr close {<number> | <url> | <branch>} [flags]
1038
+
1039
+ Close a pull request
1040
+
1041
+ -c, --comment string Leave a closing comment
1042
+ -d, --delete-branch Delete the local and remote branch after close
1043
+
1044
+ ### gh pr comment [<number> | <url> | <branch>] [flags]
1045
+
1046
+ Add a comment to a pull request
1047
+
1048
+ --attach file Attach an image or video file, in '<file>#<image alt text>' format
1049
+ -b, --body text The comment body text
1050
+ -F, --body-file file Read body text from file (use "-" to read from standard input)
1051
+ --create-if-none Create a new comment if no comments are found. Can be used only with --edit-last
1052
+ --delete-last Delete the last comment of the current user
1053
+ --edit-last Edit the last comment of the current user
1054
+ -e, --editor Skip prompts and open the text editor to write the body in
1055
+ -w, --web Open the web browser to write the comment
1056
+ --yes Skip the delete confirmation prompt when --delete-last is provided
1057
+
1058
+ ### gh pr create [flags]
1059
+
1060
+ Create a pull request
1061
+
1062
+ -a, --assignee login Assign people by their login. Use "@me" to self-assign.
1063
+ --attach file Attach an image or video file, in '<file>#<image alt text>' format
1064
+ -B, --base branch The branch into which you want your code merged
1065
+ -b, --body string Body for the pull request
1066
+ -F, --body-file file Read body text from file (use "-" to read from standard input)
1067
+ -d, --draft Mark pull request as a draft
1068
+ --dry-run Print details instead of creating the PR. May still push git changes.
1069
+ -e, --editor Skip prompts and open the text editor to write the title and body in. The first line is the title and the remaining text is the body.
1070
+ -f, --fill Use commit info for title and body
1071
+ --fill-first Use first commit info for title and body
1072
+ --fill-verbose Use commits msg+body for description
1073
+ -H, --head branch The branch that contains commits for your pull request (default [current branch])
1074
+ -l, --label name Add labels by name
1075
+ -m, --milestone name Add the pull request to a milestone by name
1076
+ --no-maintainer-edit Disable maintainer's ability to modify pull request
1077
+ -p, --project title Add the pull request to projects by title
1078
+ --recover string Recover input from a failed run of create
1079
+ -r, --reviewer handle Request reviews from people or teams by their handle
1080
+ -T, --template file Template file to use as starting body text
1081
+ -t, --title string Title for the pull request
1082
+ -w, --web Open the web browser to create a pull request
1083
+
1084
+ Aliases
1085
+
1086
+ gh pr new
1087
+
1088
+ ### gh pr diff [<number> | <url> | <branch>] [flags]
1089
+
1090
+ View changes in a pull request
1091
+
1092
+ --allow-escape-sequences Allow printing terminal escape sequences
1093
+ --color string Use color in diff output: {always|never|auto} (default "auto")
1094
+ -e, --exclude patterns Exclude files matching glob patterns from the diff
1095
+ --name-only Display only names of changed files
1096
+ --patch Display diff in patch format
1097
+ -w, --web Open the pull request diff in the browser
1098
+
1099
+ ### gh pr edit [<number> | <url> | <branch>] [flags]
1100
+
1101
+ Edit a pull request
1102
+
1103
+ --add-assignee login Add assigned users by their login. Use "@me" to assign yourself, or "@copilot" to assign Copilot.
1104
+ --add-label name Add labels by name
1105
+ --add-project title Add the pull request to projects by title
1106
+ --add-reviewer login Add or re-request reviewers by their login. Use "@copilot" to request review from Copilot.
1107
+ --attach file Attach an image or video file, in '<file>#<image alt text>' format
1108
+ -B, --base branch Change the base branch for this pull request
1109
+ -b, --body string Set the new body.
1110
+ -F, --body-file file Read body text from file (use "-" to read from standard input)
1111
+ -m, --milestone name Edit the milestone the pull request belongs to by name
1112
+ --remove-assignee login Remove assigned users by their login. Use "@me" to unassign yourself, or "@copilot" to unassign Copilot.
1113
+ --remove-label name Remove labels by name
1114
+ --remove-milestone Remove the milestone association from the pull request
1115
+ --remove-project title Remove the pull request from projects by title
1116
+ --remove-reviewer login Remove reviewers by their login. Use "@copilot" to remove review request from Copilot.
1117
+ -t, --title string Set the new title.
1118
+
1119
+ ### gh pr list [flags]
1120
+
1121
+ List pull requests in a repository
1122
+
1123
+ --app string Filter by GitHub App author
1124
+ -a, --assignee string Filter by assignee
1125
+ -A, --author string Filter by author (use --app to filter by a GitHub App)
1126
+ -B, --base string Filter by base branch
1127
+ -d, --draft Filter by draft state
1128
+ -H, --head string Filter by head branch ("<owner>:<branch>" syntax not supported)
1129
+ -q, --jq expression Filter JSON output using a jq expression
1130
+ --json fields Output JSON with the specified fields
1131
+ -l, --label strings Filter by label
1132
+ -L, --limit int Maximum number of items to fetch (default 30)
1133
+ -S, --search query Search pull requests with query
1134
+ -s, --state string Filter by state: {open|closed|merged|all} (default "open")
1135
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1136
+ -w, --web List pull requests in the web browser
1137
+
1138
+ Aliases
1139
+
1140
+ gh pr ls
1141
+
1142
+ ### gh pr lock {<number> | <url>} [flags]
1143
+
1144
+ Lock pull request conversation
1145
+
1146
+ -r, --reason string Optional reason for locking conversation (off_topic, resolved, spam, too_heated).
1147
+
1148
+ ### gh pr merge [<number> | <url> | <branch>] [flags]
1149
+
1150
+ Merge a pull request
1151
+
1152
+ --admin Use administrator privileges to merge a pull request that does not meet requirements
1153
+ -A, --author-email text Email text for merge commit author
1154
+ --auto Automatically merge only after necessary requirements are met
1155
+ -b, --body text Body text for the merge commit
1156
+ -F, --body-file file Read body text from file (use "-" to read from standard input)
1157
+ -d, --delete-branch Delete the local and remote branch after merge
1158
+ --disable-auto Disable auto-merge for this pull request
1159
+ --match-head-commit SHA Commit SHA that the pull request head must match to allow merge
1160
+ -m, --merge Merge the commits with the base branch
1161
+ -r, --rebase Rebase the commits onto the base branch
1162
+ -s, --squash Squash the commits into one commit and merge it into the base branch
1163
+ -t, --subject text Subject text for the merge commit
1164
+
1165
+ ### gh pr ready [<number> | <url> | <branch>] [flags]
1166
+
1167
+ Mark a pull request as ready for review
1168
+
1169
+ --undo Convert a pull request to "draft"
1170
+
1171
+ ### gh pr reopen {<number> | <url> | <branch>} [flags]
1172
+
1173
+ Reopen a pull request
1174
+
1175
+ -c, --comment string Add a reopening comment
1176
+
1177
+ ### gh pr revert {<number> | <url> | <branch>} [flags]
1178
+
1179
+ Revert a pull request
1180
+
1181
+ -b, --body string Body for the revert pull request
1182
+ -F, --body-file file Read body text from file (use "-" to read from standard input)
1183
+ -d, --draft Mark revert pull request as a draft
1184
+ -t, --title string Title for the revert pull request
1185
+
1186
+ ### gh pr review [<number> | <url> | <branch>] [flags]
1187
+
1188
+ Add a review to a pull request
1189
+
1190
+ -a, --approve Approve pull request
1191
+ -b, --body string Specify the body of a review
1192
+ -F, --body-file file Read body text from file (use "-" to read from standard input)
1193
+ -c, --comment Comment on a pull request
1194
+ -r, --request-changes Request changes on a pull request
1195
+
1196
+ ### gh pr status [flags]
1197
+
1198
+ Show status of relevant pull requests
1199
+
1200
+ -c, --conflict-status Display the merge conflict status of each pull request
1201
+ -q, --jq expression Filter JSON output using a jq expression
1202
+ --json fields Output JSON with the specified fields
1203
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1204
+
1205
+ ### gh pr unlock {<number> | <url>}
1206
+
1207
+ Unlock pull request conversation
1208
+
1209
+ ### gh pr update-branch [<number> | <url> | <branch>] [flags]
1210
+
1211
+ Update a pull request branch
1212
+
1213
+ --rebase Update PR branch by rebasing on top of latest base branch
1214
+
1215
+ ### gh pr view [<number> | <url> | <branch>] [flags]
1216
+
1217
+ View a pull request
1218
+
1219
+ -c, --comments View pull request comments
1220
+ -q, --jq expression Filter JSON output using a jq expression
1221
+ --json fields Output JSON with the specified fields
1222
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1223
+ -w, --web Open a pull request in the browser
1224
+
1225
+ ## gh preview <command>
1226
+
1227
+ Execute previews for gh features
1228
+
1229
+ ### gh preview prompter [prompt type]
1230
+
1231
+ Execute a test program to preview the prompter
1232
+
1233
+ ## gh project <command>
1234
+
1235
+ Work with GitHub Projects.
1236
+
1237
+ ### gh project close [<number>] [flags]
1238
+
1239
+ Close a project
1240
+
1241
+ --format string Output format: {json}
1242
+ -q, --jq expression Filter JSON output using a jq expression
1243
+ --owner string Login of the owner. Use "@me" for the current user.
1244
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1245
+ --undo Reopen a closed project
1246
+
1247
+ ### gh project copy [<number>] [flags]
1248
+
1249
+ Copy a project
1250
+
1251
+ --drafts Include draft issues when copying
1252
+ --format string Output format: {json}
1253
+ -q, --jq expression Filter JSON output using a jq expression
1254
+ --source-owner string Login of the source owner. Use "@me" for the current user.
1255
+ --target-owner string Login of the target owner. Use "@me" for the current user.
1256
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1257
+ --title string Title for the new project
1258
+
1259
+ ### gh project create [flags]
1260
+
1261
+ Create a project
1262
+
1263
+ --format string Output format: {json}
1264
+ -q, --jq expression Filter JSON output using a jq expression
1265
+ --owner string Login of the owner. Use "@me" for the current user.
1266
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1267
+ --title string Title for the project
1268
+
1269
+ ### gh project delete [<number>] [flags]
1270
+
1271
+ Delete a project
1272
+
1273
+ --format string Output format: {json}
1274
+ -q, --jq expression Filter JSON output using a jq expression
1275
+ --owner string Login of the owner. Use "@me" for the current user.
1276
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1277
+
1278
+ ### gh project edit [<number>] [flags]
1279
+
1280
+ Edit a project
1281
+
1282
+ -d, --description string New description of the project
1283
+ --format string Output format: {json}
1284
+ -q, --jq expression Filter JSON output using a jq expression
1285
+ --owner string Login of the owner. Use "@me" for the current user.
1286
+ --readme string New readme for the project
1287
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1288
+ --title string New title for the project
1289
+ --visibility string Change project visibility: {PUBLIC|PRIVATE}
1290
+
1291
+ ### gh project field-create [<number>] [flags]
1292
+
1293
+ Create a field in a project
1294
+
1295
+ --data-type string DataType of the new field.: {TEXT|SINGLE_SELECT|DATE|NUMBER}
1296
+ --format string Output format: {json}
1297
+ -q, --jq expression Filter JSON output using a jq expression
1298
+ --name string Name of the new field
1299
+ --owner string Login of the owner. Use "@me" for the current user.
1300
+ --single-select-options strings Options for SINGLE_SELECT data type
1301
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1302
+
1303
+ ### gh project field-delete [flags]
1304
+
1305
+ Delete a field in a project
1306
+
1307
+ --format string Output format: {json}
1308
+ --id string ID of the field to delete
1309
+ -q, --jq expression Filter JSON output using a jq expression
1310
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1311
+
1312
+ ### gh project field-list [<number>] [flags]
1313
+
1314
+ List the fields in a project
1315
+
1316
+ --format string Output format: {json}
1317
+ -q, --jq expression Filter JSON output using a jq expression
1318
+ -L, --limit int Maximum number of fields to fetch (default 30)
1319
+ --owner string Login of the owner. Use "@me" for the current user.
1320
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1321
+
1322
+ ### gh project item-add [<number>] [flags]
1323
+
1324
+ Add a pull request or an issue to a project
1325
+
1326
+ --format string Output format: {json}
1327
+ -q, --jq expression Filter JSON output using a jq expression
1328
+ --owner string Login of the owner. Use "@me" for the current user.
1329
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1330
+ --url string URL of the issue or pull request to add to the project
1331
+
1332
+ ### gh project item-archive [<number>] [flags]
1333
+
1334
+ Archive an item in a project
1335
+
1336
+ --format string Output format: {json}
1337
+ --id string ID of the item to archive
1338
+ -q, --jq expression Filter JSON output using a jq expression
1339
+ --owner string Login of the owner. Use "@me" for the current user.
1340
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1341
+ --undo Unarchive an item
1342
+
1343
+ ### gh project item-create [<number>] [flags]
1344
+
1345
+ Create a draft issue item in a project
1346
+
1347
+ --body string Body for the draft issue
1348
+ --format string Output format: {json}
1349
+ -q, --jq expression Filter JSON output using a jq expression
1350
+ --owner string Login of the owner. Use "@me" for the current user.
1351
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1352
+ --title string Title for the draft issue
1353
+
1354
+ ### gh project item-delete [<number>] [flags]
1355
+
1356
+ Delete an item from a project by ID
1357
+
1358
+ --format string Output format: {json}
1359
+ --id string ID of the item to delete
1360
+ -q, --jq expression Filter JSON output using a jq expression
1361
+ --owner string Login of the owner. Use "@me" for the current user.
1362
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1363
+
1364
+ ### gh project item-edit [<number>] [flags]
1365
+
1366
+ Edit an item in a project
1367
+
1368
+ --body string Body of the draft issue item
1369
+ --clear Remove field value
1370
+ --date string Date value for the field (YYYY-MM-DD)
1371
+ --field string Name of the field to update
1372
+ --field-id string ID of the field to update
1373
+ --format string Output format: {json}
1374
+ --id string ID of the item to edit
1375
+ --iteration-id string ID of the iteration value to set on the field
1376
+ -q, --jq expression Filter JSON output using a jq expression
1377
+ --number float Number value for the field
1378
+ --owner string Login of the owner. Use "@me" for the current user.
1379
+ --project-id string ID of the project to which the field belongs to
1380
+ --single-select-option-id string ID of the single select option value to set on the field
1381
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1382
+ --text string Text value for the field
1383
+ --title string Title of the draft issue item
1384
+ --url string URL of the issue or pull request whose project item to edit
1385
+ --value --field Value to set on the field named by --field
1386
+
1387
+ ### gh project item-list [<number>] [flags]
1388
+
1389
+ List the items in a project
1390
+
1391
+ --field stringArray Name of a field to show as an extra column
1392
+ --field-id stringArray ID of a field to show as an extra column
1393
+ --format string Output format: {json}
1394
+ -q, --jq expression Filter JSON output using a jq expression
1395
+ -L, --limit int Maximum number of items to fetch (default 30)
1396
+ --owner string Login of the owner. Use "@me" for the current user
1397
+ --query string Filter items using the Projects filter syntax, e.g. "assignee:octocat -status:Done"
1398
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1399
+
1400
+ ### gh project link [<number>] [flags]
1401
+
1402
+ Link a project to a repository or a team
1403
+
1404
+ --owner string Login of the owner. Use "@me" for the current user.
1405
+ -R, --repo string The repository to be linked to this project
1406
+ -T, --team string The team to be linked to this project
1407
+
1408
+ ### gh project list [flags]
1409
+
1410
+ List the projects for an owner
1411
+
1412
+ --closed Include closed projects
1413
+ --format string Output format: {json}
1414
+ -q, --jq expression Filter JSON output using a jq expression
1415
+ -L, --limit int Maximum number of projects to fetch (default 30)
1416
+ --owner string Login of the owner
1417
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1418
+ -w, --web Open projects list in the browser
1419
+
1420
+ Aliases
1421
+
1422
+ gh project ls
1423
+
1424
+ ### gh project mark-template [<number>] [flags]
1425
+
1426
+ Mark a project as a template
1427
+
1428
+ --format string Output format: {json}
1429
+ -q, --jq expression Filter JSON output using a jq expression
1430
+ --owner string Login of the org owner.
1431
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1432
+ --undo Unmark the project as a template.
1433
+
1434
+ ### gh project unlink [<number>] [flags]
1435
+
1436
+ Unlink a project from a repository or a team
1437
+
1438
+ --owner string Login of the owner. Use "@me" for the current user.
1439
+ -R, --repo string The repository to be unlinked from this project
1440
+ -T, --team string The team to be unlinked from this project
1441
+
1442
+ ### gh project view [<number>] [flags]
1443
+
1444
+ View a project
1445
+
1446
+ --format string Output format: {json}
1447
+ -q, --jq expression Filter JSON output using a jq expression
1448
+ --owner string Login of the owner. Use "@me" for the current user.
1449
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1450
+ -w, --web Open a project in the browser
1451
+
1452
+ ## gh release <command>
1453
+
1454
+ Manage releases
1455
+
1456
+ ### gh release create [<tag>] [<filename>... | <pattern>...]
1457
+
1458
+ Create a new release
1459
+
1460
+ --discussion-category string Start a discussion in the specified category
1461
+ -d, --draft Save the release as a draft instead of publishing it
1462
+ --fail-on-no-commits Fail if there are no commits since the last release (no impact on the first release)
1463
+ --generate-notes Automatically generate title and notes for the release via GitHub Release Notes API
1464
+ --latest Mark this release as "Latest" (default [automatic based on date and version]). --latest=false to explicitly NOT set as latest
1465
+ -n, --notes string Release notes
1466
+ -F, --notes-file file Read release notes from file (use "-" to read from standard input)
1467
+ --notes-from-tag Fetch notes from the tag annotation or message of commit associated with tag
1468
+ --notes-start-tag string Tag to use as the starting point for generating release notes
1469
+ -p, --prerelease Mark the release as a prerelease
1470
+ --target branch Target branch or full commit SHA (default [main branch])
1471
+ -t, --title string Release title
1472
+ --verify-tag Abort in case the git tag doesn't already exist in the remote repository
1473
+
1474
+ Aliases
1475
+
1476
+ gh release new
1477
+
1478
+ ### gh release delete <tag> [flags]
1479
+
1480
+ Delete a release
1481
+
1482
+ --cleanup-tag Delete the specified tag in addition to its release
1483
+ -y, --yes Skip the confirmation prompt
1484
+
1485
+ ### gh release delete-asset <tag> <asset-name> [flags]
1486
+
1487
+ Delete an asset from a release
1488
+
1489
+ -y, --yes Skip the confirmation prompt
1490
+
1491
+ ### gh release download [<tag>] [flags]
1492
+
1493
+ Download release assets
1494
+
1495
+ --allow-escape-sequences Allow printing terminal escape sequences when writing an asset to standard output
1496
+ -A, --archive format Download the source code archive in the specified format (zip or tar.gz)
1497
+ --clobber Overwrite existing files of the same name
1498
+ -D, --dir directory The directory to download files into (default ".")
1499
+ -O, --output file The file to write a single asset to (use "-" to write to standard output)
1500
+ -p, --pattern stringArray Download only assets that match a glob pattern
1501
+ --skip-existing Skip downloading when files of the same name exist
1502
+
1503
+ ### gh release edit <tag>
1504
+
1505
+ Edit a release
1506
+
1507
+ --discussion-category string Start a discussion in the specified category when publishing a draft
1508
+ --draft Save the release as a draft instead of publishing it
1509
+ --latest Explicitly mark the release as "Latest"
1510
+ -n, --notes string Release notes
1511
+ -F, --notes-file file Read release notes from file (use "-" to read from standard input)
1512
+ --prerelease Mark the release as a prerelease
1513
+ --tag string The name of the tag
1514
+ --target branch Target branch or full commit SHA (default [main branch])
1515
+ -t, --title string Release title
1516
+ --verify-tag Abort in case the git tag doesn't already exist in the remote repository
1517
+
1518
+ ### gh release list [flags]
1519
+
1520
+ List releases in a repository
1521
+
1522
+ --exclude-drafts Exclude draft releases
1523
+ --exclude-pre-releases Exclude pre-releases
1524
+ -q, --jq expression Filter JSON output using a jq expression
1525
+ --json fields Output JSON with the specified fields
1526
+ -L, --limit int Maximum number of items to fetch (default 30)
1527
+ -O, --order string Order of releases returned: {asc|desc} (default "desc")
1528
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1529
+
1530
+ Aliases
1531
+
1532
+ gh release ls
1533
+
1534
+ ### gh release upload <tag> <files>... [flags]
1535
+
1536
+ Upload assets to a release
1537
+
1538
+ --clobber Delete and re-upload existing assets of the same name
1539
+
1540
+ ### gh release verify [<tag>] [flags]
1541
+
1542
+ Verify the attestation for a release
1543
+
1544
+ --format string Output format: {json}
1545
+ -q, --jq expression Filter JSON output using a jq expression
1546
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1547
+
1548
+ ### gh release verify-asset [<tag>] <file-path> [flags]
1549
+
1550
+ Verify that a given asset originated from a release
1551
+
1552
+ --format string Output format: {json}
1553
+ -q, --jq expression Filter JSON output using a jq expression
1554
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1555
+
1556
+ ### gh release view [<tag>] [flags]
1557
+
1558
+ View information about a release
1559
+
1560
+ -q, --jq expression Filter JSON output using a jq expression
1561
+ --json fields Output JSON with the specified fields
1562
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1563
+ -w, --web Open the release in the browser
1564
+
1565
+ ## gh repo <command>
1566
+
1567
+ Manage repositories
1568
+
1569
+ ### gh repo archive [<repository>] [flags]
1570
+
1571
+ Archive a repository
1572
+
1573
+ -y, --yes Skip the confirmation prompt
1574
+
1575
+ ### gh repo autolink <command>
1576
+
1577
+ Manage autolink references
1578
+
1579
+ #### gh repo autolink create <keyPrefix> <urlTemplate> [flags]
1580
+
1581
+ Create a new autolink reference
1582
+
1583
+ -n, --numeric Mark autolink as numeric
1584
+
1585
+ Aliases
1586
+
1587
+ gh repo autolink new
1588
+
1589
+ #### gh repo autolink delete <id> [flags]
1590
+
1591
+ Delete an autolink reference
1592
+
1593
+ --yes Confirm deletion without prompting
1594
+
1595
+ #### gh repo autolink list [flags]
1596
+
1597
+ List autolink references for a GitHub repository
1598
+
1599
+ -q, --jq expression Filter JSON output using a jq expression
1600
+ --json fields Output JSON with the specified fields
1601
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1602
+ -w, --web List autolink references in the web browser
1603
+
1604
+ Aliases
1605
+
1606
+ gh repo autolink ls
1607
+
1608
+ #### gh repo autolink view <id> [flags]
1609
+
1610
+ View an autolink reference
1611
+
1612
+ -q, --jq expression Filter JSON output using a jq expression
1613
+ --json fields Output JSON with the specified fields
1614
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1615
+
1616
+ ### gh repo clone <repository> [<directory>] [-- <gitflags>...]
1617
+
1618
+ Clone a repository locally
1619
+
1620
+ --no-upstream Do not add an upstream remote when cloning a fork
1621
+ -u, --upstream-remote-name string Upstream remote name when cloning a fork (default "upstream")
1622
+
1623
+ ### gh repo create [<name>] [flags]
1624
+
1625
+ Create a new repository
1626
+
1627
+ --add-readme Add a README file to the new repository
1628
+ -c, --clone Clone the new repository to the current directory
1629
+ -d, --description string Description of the repository
1630
+ --disable-issues Disable issues in the new repository
1631
+ --disable-wiki Disable wiki in the new repository
1632
+ -g, --gitignore string Specify a gitignore template for the repository
1633
+ -h, --homepage URL Repository home page URL
1634
+ --include-all-branches Include all branches from template repository
1635
+ --internal Make the new repository internal
1636
+ -l, --license string Specify an Open Source License for the repository
1637
+ --private Make the new repository private
1638
+ --public Make the new repository public
1639
+ --push Push local commits to the new repository
1640
+ -r, --remote string Specify remote name for the new repository
1641
+ -s, --source string Specify path to local repository to use as source
1642
+ -t, --team name The name of the organization team to be granted access
1643
+ -p, --template repository Make the new repository based on a template repository
1644
+
1645
+ Aliases
1646
+
1647
+ gh repo new
1648
+
1649
+ ### gh repo delete [<repository>] [flags]
1650
+
1651
+ Delete a repository
1652
+
1653
+ --yes Confirm deletion without prompting
1654
+
1655
+ ### gh repo deploy-key <command>
1656
+
1657
+ Manage deploy keys in a repository
1658
+
1659
+ #### gh repo deploy-key add <key-file> [flags]
1660
+
1661
+ Add a deploy key to a GitHub repository
1662
+
1663
+ -w, --allow-write Allow write access for the key
1664
+ -t, --title string Title of the new key
1665
+
1666
+ #### gh repo deploy-key delete <key-id>
1667
+
1668
+ Delete a deploy key from a GitHub repository
1669
+
1670
+ #### gh repo deploy-key list [flags]
1671
+
1672
+ List deploy keys in a GitHub repository
1673
+
1674
+ -q, --jq expression Filter JSON output using a jq expression
1675
+ --json fields Output JSON with the specified fields
1676
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1677
+
1678
+ Aliases
1679
+
1680
+ gh repo deploy-key ls
1681
+
1682
+ ### gh repo edit [<repository>] [flags]
1683
+
1684
+ Edit repository settings
1685
+
1686
+ --accept-visibility-change-consequences Accept the consequences of changing the repository visibility
1687
+ --add-topic strings Add repository topic
1688
+ --allow-forking Allow forking of an organization repository
1689
+ --allow-update-branch Allow a pull request head branch that is behind its base branch to be updated
1690
+ --default-branch name Set the default branch name for the repository
1691
+ --delete-branch-on-merge Delete head branch when pull requests are merged
1692
+ -d, --description string Description of the repository
1693
+ --enable-advanced-security Enable advanced security in the repository
1694
+ --enable-auto-merge Enable auto-merge functionality
1695
+ --enable-discussions Enable discussions in the repository
1696
+ --enable-issues Enable issues in the repository
1697
+ --enable-merge-commit Enable merging pull requests via merge commit
1698
+ --enable-projects Enable projects in the repository
1699
+ --enable-rebase-merge Enable merging pull requests via rebase
1700
+ --enable-secret-scanning Enable secret scanning in the repository
1701
+ --enable-secret-scanning-push-protection Enable secret scanning push protection in the repository. Secret scanning must be enabled first
1702
+ --enable-squash-merge Enable merging pull requests via squashed commit
1703
+ --enable-wiki Enable wiki in the repository
1704
+ -h, --homepage URL Repository home page URL
1705
+ --remove-topic strings Remove repository topic
1706
+ --squash-merge-commit-message string The default value for a squash merge commit message: {default|pr-title|pr-title-commits|pr-title-description}
1707
+ --template Make the repository available as a template repository
1708
+ --visibility string Change the visibility of the repository to {public,private,internal}
1709
+
1710
+ ### gh repo fork [<repository>] [-- <gitflags>...] [flags]
1711
+
1712
+ Create a fork of a repository
1713
+
1714
+ --clone Clone the fork
1715
+ --default-branch-only Only include the default branch in the fork
1716
+ --fork-name string Rename the forked repository
1717
+ --org string Create the fork in an organization
1718
+ --remote Add a git remote for the fork
1719
+ --remote-name string Specify the name for the new remote (default "origin")
1720
+
1721
+ ### gh repo gitignore <command>
1722
+
1723
+ List and view available repository gitignore templates
1724
+
1725
+ #### gh repo gitignore list
1726
+
1727
+ List available repository gitignore templates
1728
+
1729
+ Aliases
1730
+
1731
+ gh repo gitignore ls
1732
+
1733
+ #### gh repo gitignore view <template>
1734
+
1735
+ View an available repository gitignore template
1736
+
1737
+ ### gh repo license <command>
1738
+
1739
+ Explore repository licenses
1740
+
1741
+ #### gh repo license list
1742
+
1743
+ List common repository licenses
1744
+
1745
+ Aliases
1746
+
1747
+ gh repo license ls
1748
+
1749
+ #### gh repo license view {<license-key> | <spdx-id>} [flags]
1750
+
1751
+ View a specific repository license
1752
+
1753
+ -w, --web Open https://choosealicense.com/ in the browser
1754
+
1755
+ ### gh repo list [<owner>] [flags]
1756
+
1757
+ List repositories owned by user or organization
1758
+
1759
+ --archived Show only archived repositories
1760
+ --fork Show only forks
1761
+ -q, --jq expression Filter JSON output using a jq expression
1762
+ --json fields Output JSON with the specified fields
1763
+ -l, --language string Filter by primary coding language
1764
+ -L, --limit int Maximum number of repositories to list (default 30)
1765
+ --no-archived Omit archived repositories
1766
+ --source Show only non-forks
1767
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1768
+ --topic strings Filter by topic
1769
+ --visibility string Filter by repository visibility: {public|private|internal}
1770
+
1771
+ Aliases
1772
+
1773
+ gh repo ls
1774
+
1775
+ ### gh repo read-dir [<path>] [flags]
1776
+
1777
+ List a directory in a repository (preview)
1778
+
1779
+ -q, --jq expression Filter JSON output using a jq expression
1780
+ --json fields Output JSON with the specified fields
1781
+ --ref string The branch, tag, or commit to list from
1782
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1783
+
1784
+ ### gh repo read-file <path> [flags]
1785
+
1786
+ Read a file from a repository (preview)
1787
+
1788
+ --allow-escape-sequences Allow printing terminal escape sequences
1789
+ --clobber Overwrite the output path if it already exists
1790
+ -q, --jq expression Filter JSON output using a jq expression
1791
+ --json fields Output JSON with the specified fields
1792
+ -o, --output path Write the file to a path instead of stdout
1793
+ --ref string The branch, tag, or commit to read from
1794
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1795
+
1796
+ ### gh repo rename [<new-name>] [flags]
1797
+
1798
+ Rename a repository
1799
+
1800
+ -y, --yes Skip the confirmation prompt
1801
+
1802
+ ### gh repo set-default [<repository>] [flags]
1803
+
1804
+ Configure default repository for this directory
1805
+
1806
+ -u, --unset Unset the current default repository
1807
+ -v, --view View the current default repository
1808
+
1809
+ ### gh repo sync [<destination-repository>] [flags]
1810
+
1811
+ Sync a repository
1812
+
1813
+ -b, --branch string Branch to sync (default [default branch])
1814
+ --force Hard reset the branch of the destination repository to match the source repository
1815
+ -s, --source string Source repository
1816
+
1817
+ ### gh repo unarchive [<repository>] [flags]
1818
+
1819
+ Unarchive a repository
1820
+
1821
+ -y, --yes Skip the confirmation prompt
1822
+
1823
+ ### gh repo view [<repository>] [flags]
1824
+
1825
+ View a repository
1826
+
1827
+ -b, --branch string View a specific branch of the repository
1828
+ -q, --jq expression Filter JSON output using a jq expression
1829
+ --json fields Output JSON with the specified fields
1830
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1831
+ -w, --web Open a repository in the browser
1832
+
1833
+ ## gh ruleset <command>
1834
+
1835
+ View info about repo rulesets
1836
+
1837
+ Aliases
1838
+
1839
+ gh rs
1840
+
1841
+ ### gh ruleset check [<branch>] [flags]
1842
+
1843
+ View rules that would apply to a given branch
1844
+
1845
+ --default Check rules on default branch
1846
+ -w, --web Open the branch rules page in a web browser
1847
+
1848
+ ### gh ruleset list [flags]
1849
+
1850
+ List rulesets for a repository or organization
1851
+
1852
+ -L, --limit int Maximum number of rulesets to list (default 30)
1853
+ -o, --org string List organization-wide rulesets for the provided organization
1854
+ -p, --parents Whether to include rulesets configured at higher levels that also apply (default true)
1855
+ -w, --web Open the list of rulesets in the web browser
1856
+
1857
+ Aliases
1858
+
1859
+ gh rs ls, gh ruleset ls
1860
+
1861
+ ### gh ruleset view [<ruleset-id>] [flags]
1862
+
1863
+ View information about a ruleset
1864
+
1865
+ -o, --org string Organization name if the provided ID is an organization-level ruleset
1866
+ -p, --parents Whether to include rulesets configured at higher levels that also apply (default true)
1867
+ -w, --web Open the ruleset in the browser
1868
+
1869
+ ## gh run <command>
1870
+
1871
+ View details about workflow runs
1872
+
1873
+ ### gh run cancel [<run-id>] [flags]
1874
+
1875
+ Cancel a workflow run
1876
+
1877
+ --force Force cancel a workflow run
1878
+
1879
+ ### gh run delete [<run-id>]
1880
+
1881
+ Delete a workflow run
1882
+
1883
+ ### gh run download [<run-id>] [flags]
1884
+
1885
+ Download artifacts generated by a workflow run
1886
+
1887
+ -D, --dir string The directory to download artifacts into (default ".")
1888
+ -n, --name stringArray Download artifacts that match any of the given names
1889
+ -p, --pattern stringArray Download artifacts that match a glob pattern
1890
+
1891
+ ### gh run list [flags]
1892
+
1893
+ List recent workflow runs
1894
+
1895
+ -a, --all Include disabled workflows
1896
+ -b, --branch string Filter runs by branch
1897
+ -c, --commit SHA Filter runs by the SHA of the commit
1898
+ --created date Filter runs by the date it was created
1899
+ -e, --event event Filter runs by which event triggered the run
1900
+ -q, --jq expression Filter JSON output using a jq expression
1901
+ --json fields Output JSON with the specified fields
1902
+ -L, --limit int Maximum number of runs to fetch (default 20)
1903
+ -s, --status string Filter runs by status: {queued|completed|in_progress|requested|waiting|pending|action_required|cancelled|failure|neutral|skipped|stale|startup_failure|success|timed_out}
1904
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1905
+ -u, --user string Filter runs by user who triggered the run
1906
+ -w, --workflow string Filter runs by workflow
1907
+
1908
+ Aliases
1909
+
1910
+ gh run ls
1911
+
1912
+ ### gh run rerun [<run-id>] [flags]
1913
+
1914
+ Rerun a run
1915
+
1916
+ -d, --debug Rerun with debug logging
1917
+ --failed Rerun only failed jobs, including dependencies
1918
+ -j, --job string Rerun a specific job ID from a run, including dependencies
1919
+
1920
+ ### gh run view [<run-id>] [flags]
1921
+
1922
+ View a summary of a workflow run
1923
+
1924
+ -a, --attempt uint The attempt number of the workflow run
1925
+ --exit-status Exit with non-zero status if run failed
1926
+ -j, --job string View a specific job ID from a run
1927
+ -q, --jq expression Filter JSON output using a jq expression
1928
+ --json fields Output JSON with the specified fields
1929
+ --log View full log for either a run or specific job
1930
+ --log-failed View the log for any failed steps in a run or specific job
1931
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1932
+ -v, --verbose Show job steps
1933
+ -w, --web Open run in the browser
1934
+
1935
+ ### gh run watch <run-id> [flags]
1936
+
1937
+ Watch a run until it completes, showing its progress
1938
+
1939
+ --compact Show only relevant/failed steps
1940
+ --exit-status Exit with non-zero status if run fails
1941
+ -i, --interval int Refresh interval in seconds (default 3)
1942
+
1943
+ ## gh search <command>
1944
+
1945
+ Search for repositories, issues, and pull requests
1946
+
1947
+ ### gh search code <query> [flags]
1948
+
1949
+ Search within code
1950
+
1951
+ --extension string Filter on file extension
1952
+ --filename string Filter on filename
1953
+ -q, --jq expression Filter JSON output using a jq expression
1954
+ --json fields Output JSON with the specified fields
1955
+ --language string Filter results by language
1956
+ -L, --limit int Maximum number of code results to fetch (default 30)
1957
+ --match strings Restrict search to file contents or file path: {file|path}
1958
+ --owner strings Filter on owner
1959
+ -R, --repo OWNER/REPO Filter on repository, in OWNER/REPO format
1960
+ --size string Filter on size range, in kilobytes
1961
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1962
+ -w, --web Open the search query in the web browser
1963
+
1964
+ ### gh search commits [<query>] [flags]
1965
+
1966
+ Search for commits
1967
+
1968
+ --author string Filter by author
1969
+ --author-date date Filter based on authored date
1970
+ --author-email string Filter on author email
1971
+ --author-name string Filter on author name
1972
+ --committer string Filter by committer
1973
+ --committer-date date Filter based on committed date
1974
+ --committer-email string Filter on committer email
1975
+ --committer-name string Filter on committer name
1976
+ --hash string Filter by commit hash
1977
+ -q, --jq expression Filter JSON output using a jq expression
1978
+ --json fields Output JSON with the specified fields
1979
+ -L, --limit int Maximum number of commits to fetch (default 30)
1980
+ --merge Filter on merge commits
1981
+ --order string Order of commits returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
1982
+ --owner strings Filter on repository owner
1983
+ --parent string Filter by parent hash
1984
+ -R, --repo OWNER/REPO Filter on repository, in OWNER/REPO format
1985
+ --sort string Sort fetched commits: {author-date|committer-date} (default "best-match")
1986
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
1987
+ --tree string Filter by tree hash
1988
+ --visibility strings Filter based on repository visibility: {public|private|internal}
1989
+ -w, --web Open the search query in the web browser
1990
+
1991
+ ### gh search issues [<query>] [flags]
1992
+
1993
+ Search for issues
1994
+
1995
+ --app string Filter by GitHub App author
1996
+ --archived Filter based on the repository archived state {true|false}
1997
+ --assignee string Filter by assignee
1998
+ --author string Filter by author (use --app to filter by a GitHub App)
1999
+ --closed date Filter on closed at date
2000
+ --commenter user Filter based on comments by user
2001
+ --comments number Filter on number of comments
2002
+ --created date Filter based on created at date
2003
+ --include-prs Include pull requests in results
2004
+ --interactions number Filter on number of reactions and comments
2005
+ --involves user Filter based on involvement of user
2006
+ -q, --jq expression Filter JSON output using a jq expression
2007
+ --json fields Output JSON with the specified fields
2008
+ --label strings Filter on label
2009
+ --language string Filter based on the coding language
2010
+ -L, --limit int Maximum number of results to fetch (default 30)
2011
+ --locked Filter on locked conversation status
2012
+ --match strings Restrict search to specific field of issue: {title|body|comments}
2013
+ --mentions user Filter based on user mentions
2014
+ --milestone title Filter by milestone title
2015
+ --no-assignee Filter on missing assignee
2016
+ --no-label Filter on missing label
2017
+ --no-milestone Filter on missing milestone
2018
+ --no-project Filter on missing project
2019
+ --order string Order of results returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
2020
+ --owner strings Filter on repository owner
2021
+ --project owner/number Filter on project board owner/number
2022
+ --reactions number Filter on number of reactions
2023
+ -R, --repo OWNER/REPO Filter on repository, in OWNER/REPO format
2024
+ --search-type string Type of issue search to perform: {lexical|semantic|hybrid} (default "lexical")
2025
+ --sort string Sort fetched results: {comments|created|interactions|reactions|reactions-+1|reactions--1|reactions-heart|reactions-smile|reactions-tada|reactions-thinking_face|updated} (default "best-match")
2026
+ --state string Filter based on state: {open|closed}
2027
+ --team-mentions string Filter based on team mentions
2028
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
2029
+ --updated date Filter on last updated at date
2030
+ --visibility strings Filter based on repository visibility: {public|private|internal}
2031
+ -w, --web Open the search query in the web browser
2032
+
2033
+ ### gh search prs [<query>] [flags]
2034
+
2035
+ Search for pull requests
2036
+
2037
+ --app string Filter by GitHub App author
2038
+ --archived Filter based on the repository archived state {true|false}
2039
+ --assignee string Filter by assignee
2040
+ --author string Filter by author (use --app to filter by a GitHub App)
2041
+ -B, --base string Filter on base branch name
2042
+ --checks string Filter based on status of the checks: {pending|success|failure}
2043
+ --closed date Filter on closed at date
2044
+ --commenter user Filter based on comments by user
2045
+ --comments number Filter on number of comments
2046
+ --created date Filter based on created at date
2047
+ --draft Filter based on draft state
2048
+ -H, --head string Filter on head branch name
2049
+ --interactions number Filter on number of reactions and comments
2050
+ --involves user Filter based on involvement of user
2051
+ -q, --jq expression Filter JSON output using a jq expression
2052
+ --json fields Output JSON with the specified fields
2053
+ --label strings Filter on label
2054
+ --language string Filter based on the coding language
2055
+ -L, --limit int Maximum number of results to fetch (default 30)
2056
+ --locked Filter on locked conversation status
2057
+ --match strings Restrict search to specific field of issue: {title|body|comments}
2058
+ --mentions user Filter based on user mentions
2059
+ --merged Filter based on merged state
2060
+ --merged-at date Filter on merged at date
2061
+ --milestone title Filter by milestone title
2062
+ --no-assignee Filter on missing assignee
2063
+ --no-label Filter on missing label
2064
+ --no-milestone Filter on missing milestone
2065
+ --no-project Filter on missing project
2066
+ --order string Order of results returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
2067
+ --owner strings Filter on repository owner
2068
+ --project owner/number Filter on project board owner/number
2069
+ --reactions number Filter on number of reactions
2070
+ -R, --repo OWNER/REPO Filter on repository, in OWNER/REPO format
2071
+ --review string Filter based on review status: {none|required|approved|changes_requested}
2072
+ --review-requested user Filter on user or team requested to review
2073
+ --reviewed-by user Filter on user who reviewed
2074
+ --sort string Sort fetched results: {comments|reactions|reactions-+1|reactions--1|reactions-smile|reactions-thinking_face|reactions-heart|reactions-tada|interactions|created|updated} (default "best-match")
2075
+ --state string Filter based on state: {open|closed}
2076
+ --team-mentions string Filter based on team mentions
2077
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
2078
+ --updated date Filter on last updated at date
2079
+ --visibility strings Filter based on repository visibility: {public|private|internal}
2080
+ -w, --web Open the search query in the web browser
2081
+
2082
+ ### gh search repos [<query>] [flags]
2083
+
2084
+ Search for repositories
2085
+
2086
+ --archived Filter based on the repository archived state {true|false}
2087
+ --created date Filter based on created at date
2088
+ --followers number Filter based on number of followers
2089
+ --forks number Filter on number of forks
2090
+ --good-first-issues number Filter on number of issues with the 'good first issue' label
2091
+ --help-wanted-issues number Filter on number of issues with the 'help wanted' label
2092
+ --include-forks string Include forks in fetched repositories: {false|true|only}
2093
+ -q, --jq expression Filter JSON output using a jq expression
2094
+ --json fields Output JSON with the specified fields
2095
+ --language string Filter based on the coding language
2096
+ --license strings Filter based on license type
2097
+ -L, --limit int Maximum number of repositories to fetch (default 30)
2098
+ --match strings Restrict search to specific field of repository: {name|description|readme}
2099
+ --number-topics number Filter on number of topics
2100
+ --order string Order of repositories returned, ignored unless '--sort' flag is specified: {asc|desc} (default "desc")
2101
+ --owner strings Filter on owner
2102
+ --size string Filter on a size range, in kilobytes
2103
+ --sort string Sort fetched repositories: {forks|help-wanted-issues|stars|updated} (default "best-match")
2104
+ --stars number Filter on number of stars
2105
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
2106
+ --topic strings Filter on topic
2107
+ --updated date Filter on last updated at date
2108
+ --visibility strings Filter based on visibility: {public|private|internal}
2109
+ -w, --web Open the search query in the web browser
2110
+
2111
+ ## gh secret <command>
2112
+
2113
+ Manage GitHub secrets
2114
+
2115
+ ### gh secret delete <secret-name> [flags]
2116
+
2117
+ Delete secrets
2118
+
2119
+ -a, --app string Delete a secret for a specific application: {actions|agents|codespaces|dependabot}
2120
+ -e, --env string Delete a secret for an environment
2121
+ -o, --org string Delete a secret for an organization
2122
+ -u, --user Delete a secret for your user
2123
+
2124
+ Aliases
2125
+
2126
+ gh secret remove
2127
+
2128
+ ### gh secret list [flags]
2129
+
2130
+ List secrets
2131
+
2132
+ -a, --app string List secrets for a specific application: {actions|agents|codespaces|dependabot}
2133
+ -e, --env string List secrets for an environment
2134
+ -q, --jq expression Filter JSON output using a jq expression
2135
+ --json fields Output JSON with the specified fields
2136
+ -o, --org string List secrets for an organization
2137
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
2138
+ -u, --user List a secret for your user
2139
+
2140
+ Aliases
2141
+
2142
+ gh secret ls
2143
+
2144
+ ### gh secret set <secret-name> [flags]
2145
+
2146
+ Create or update secrets
2147
+
2148
+ -a, --app string Set the application for a secret: {actions|agents|codespaces|dependabot}
2149
+ -b, --body string The value for the secret (reads from standard input if not specified)
2150
+ -e, --env environment Set deployment environment secret
2151
+ -f, --env-file file Load secret names and values from a dotenv-formatted file
2152
+ --no-repos-selected No repositories can access the organization secret
2153
+ --no-store Print the encrypted, base64-encoded value instead of storing it on GitHub
2154
+ -o, --org organization Set organization secret
2155
+ -r, --repos repositories List of repositories that can access an organization or user secret
2156
+ -u, --user Set a secret for your user
2157
+ -v, --visibility string Set visibility for an organization secret: {all|private|selected} (default "private")
2158
+
2159
+ ## gh skill <command>
2160
+
2161
+ Install and manage agent skills (preview)
2162
+
2163
+ Aliases
2164
+
2165
+ gh skills
2166
+
2167
+ ### gh skill install <repository> [<skill[@version]>] [flags]
2168
+
2169
+ Install agent skills from a GitHub repository (preview)
2170
+
2171
+ --agent string Target agent (see supported values above)
2172
+ --all Install all skills without prompting for skill selection
2173
+ --allow-hidden-dirs Include skills in hidden directories (e.g. .claude/skills/, .agents/skills/)
2174
+ --dir string Install to a custom directory (overrides --agent and --scope)
2175
+ -f, --force Overwrite existing skills without prompting
2176
+ --from-local Treat the argument as a local directory path instead of a repository
2177
+ --pin string Pin to a specific git tag or commit SHA
2178
+ --scope string Installation scope: {project|user} (default "project")
2179
+ --upstream Install from the upstream source when a re-published skill is detected
2180
+
2181
+ Aliases
2182
+
2183
+ gh skill add, gh skills add
2184
+
2185
+ ### gh skill list [flags]
2186
+
2187
+ List installed skills (preview)
2188
+
2189
+ --agent string Filter by target agent: {github-copilot|claude-code|cursor|codex|gemini-cli|antigravity|antigravity-cli|antigravity2.0|adal|amp|augment|bob|cline|codebuddy|command-code|continue|cortex|crush|deepagents|devin|droid|firebender|goose|grok|iflow-cli|junie|kilo|kimi-cli|kiro-cli|kode|mcpjam|mistral-vibe|mux|neovate|openclaw|opencode|openhands|pi|pochi|qoder|qwen-code|replit|roo|trae|trae-cn|universal|warp|zencoder}
2190
+ --dir string Scan a custom directory for installed skills
2191
+ -q, --jq expression Filter JSON output using a jq expression
2192
+ --json fields Output JSON with the specified fields
2193
+ --scope string Filter by installation scope: {project|user}
2194
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
2195
+
2196
+ Aliases
2197
+
2198
+ gh skill ls, gh skills ls
2199
+
2200
+ ### gh skill preview <repository> [<skill>] [flags]
2201
+
2202
+ Preview a skill from a GitHub repository (preview)
2203
+
2204
+ --allow-hidden-dirs Include skills in hidden directories (e.g. .claude/skills/, .agents/skills/)
2205
+
2206
+ Aliases
2207
+
2208
+ gh skill show, gh skills show
2209
+
2210
+ ### gh skill publish [<directory>] [flags]
2211
+
2212
+ Validate and publish skills to a GitHub repository (preview)
2213
+
2214
+ --dry-run Validate without publishing
2215
+ --fix Auto-fix issues where possible without publishing (e.g. strip install metadata)
2216
+ --tag string Version tag for the release (e.g. v1.0.0)
2217
+
2218
+ ### gh skill search <query> [flags]
2219
+
2220
+ Search for skills across GitHub (preview)
2221
+
2222
+ -q, --jq expression Filter JSON output using a jq expression
2223
+ --json fields Output JSON with the specified fields
2224
+ -L, --limit int Maximum number of results per page (default 15)
2225
+ --owner string Filter results to a specific GitHub user or organization
2226
+ --page int Page number of results to fetch (default 1)
2227
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
2228
+
2229
+ ### gh skill update [<skill>...] [flags]
2230
+
2231
+ Update installed skills to their latest versions (preview)
2232
+
2233
+ --all Update all skills without prompting
2234
+ --dir string Scan a custom directory for installed skills
2235
+ --dry-run Report available updates without modifying files
2236
+ --force Re-download even if already up to date
2237
+ --unpin Clear pinned version and include pinned skills in update
2238
+
2239
+ ## gh ssh-key <command>
2240
+
2241
+ Manage SSH keys
2242
+
2243
+ ### gh ssh-key add [<key-file>] [flags]
2244
+
2245
+ Add an SSH key to your GitHub account
2246
+
2247
+ -t, --title string Title for the new key
2248
+ --type string Type of the ssh key: {authentication|signing} (default "authentication")
2249
+
2250
+ ### gh ssh-key delete <id> [flags]
2251
+
2252
+ Delete an SSH key from your GitHub account
2253
+
2254
+ -y, --yes Skip the confirmation prompt
2255
+
2256
+ ### gh ssh-key list
2257
+
2258
+ Lists SSH keys in your GitHub account
2259
+
2260
+ Aliases
2261
+
2262
+ gh ssh-key ls
2263
+
2264
+ ## gh status [flags]
2265
+
2266
+ Print information about relevant issues, pull requests, and notifications across repositories
2267
+
2268
+ -e, --exclude strings Comma separated list of repos to exclude in owner/name format
2269
+ -o, --org string Report status within an organization
2270
+
2271
+ ## gh variable <command>
2272
+
2273
+ Manage GitHub Actions variables
2274
+
2275
+ ### gh variable delete <variable-name> [flags]
2276
+
2277
+ Delete variables
2278
+
2279
+ -e, --env string Delete a variable for an environment
2280
+ -o, --org string Delete a variable for an organization
2281
+
2282
+ Aliases
2283
+
2284
+ gh variable remove
2285
+
2286
+ ### gh variable get <variable-name> [flags]
2287
+
2288
+ Get variables
2289
+
2290
+ -e, --env string Get a variable for an environment
2291
+ -q, --jq expression Filter JSON output using a jq expression
2292
+ --json fields Output JSON with the specified fields
2293
+ -o, --org string Get a variable for an organization
2294
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
2295
+
2296
+ ### gh variable list [flags]
2297
+
2298
+ List variables
2299
+
2300
+ -e, --env string List variables for an environment
2301
+ -q, --jq expression Filter JSON output using a jq expression
2302
+ --json fields Output JSON with the specified fields
2303
+ -o, --org string List variables for an organization
2304
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
2305
+
2306
+ Aliases
2307
+
2308
+ gh variable ls
2309
+
2310
+ ### gh variable set <variable-name> [flags]
2311
+
2312
+ Create or update variables
2313
+
2314
+ -b, --body string The value for the variable (reads from standard input if not specified)
2315
+ -e, --env environment Set deployment environment variable
2316
+ -f, --env-file file Load variable names and values from a dotenv-formatted file
2317
+ -o, --org organization Set organization variable
2318
+ -r, --repos repositories List of repositories that can access an organization variable
2319
+ -v, --visibility string Set visibility for an organization variable: {all|private|selected} (default "private")
2320
+
2321
+ ## gh workflow <command>
2322
+
2323
+ View details about GitHub Actions workflows
2324
+
2325
+ ### gh workflow disable [<workflow-id> | <workflow-name>]
2326
+
2327
+ Disable a workflow
2328
+
2329
+ ### gh workflow enable [<workflow-id> | <workflow-name>]
2330
+
2331
+ Enable a workflow
2332
+
2333
+ ### gh workflow list [flags]
2334
+
2335
+ List workflows
2336
+
2337
+ -a, --all Include disabled workflows
2338
+ -q, --jq expression Filter JSON output using a jq expression
2339
+ --json fields Output JSON with the specified fields
2340
+ -L, --limit int Maximum number of workflows to fetch (default 50)
2341
+ -t, --template string Format JSON output using a Go template; see "gh help formatting"
2342
+
2343
+ Aliases
2344
+
2345
+ gh workflow ls
2346
+
2347
+ ### gh workflow run [<workflow-id> | <workflow-name>] [flags]
2348
+
2349
+ Run a workflow by creating a workflow_dispatch event
2350
+
2351
+ -F, --field key=value Add a string parameter in key=value format, respecting @ syntax (see "gh help api").
2352
+ --json Read workflow inputs as JSON via STDIN
2353
+ -f, --raw-field key=value Add a string parameter in key=value format
2354
+ -r, --ref string Branch or tag name which contains the version of the workflow file you'd like to run
2355
+
2356
+ ### gh workflow view [<workflow-id> | <workflow-name> | <filename>] [flags]
2357
+
2358
+ View the summary of a workflow
2359
+
2360
+ -r, --ref string The branch or tag name which contains the version of the workflow file you'd like to view
2361
+ -w, --web Open workflow in the browser
2362
+ -y, --yaml View the workflow yaml file
2363
+