mindforge-cc 11.5.1 → 11.6.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 (170) hide show
  1. package/.agent/mindforge/skill-tdd.md +53 -0
  2. package/.agent/mindforge/skills-index.md +118 -0
  3. package/.agent/mindforge/systematic-debug.md +60 -0
  4. package/.agent/skills/1password-skill/SKILL.md +156 -0
  5. package/.agent/skills/1password-skill/references/cli-examples.md +31 -0
  6. package/.agent/skills/1password-skill/references/get-started.md +21 -0
  7. package/.agent/skills/article-illustrator/SKILL.md +199 -0
  8. package/.agent/skills/article-illustrator/references/prompt-construction.md +426 -0
  9. package/.agent/skills/article-illustrator/references/style-presets.md +80 -0
  10. package/.agent/skills/article-illustrator/references/styles.md +224 -0
  11. package/.agent/skills/article-illustrator/references/usage.md +50 -0
  12. package/.agent/skills/article-illustrator/references/workflow.md +332 -0
  13. package/.agent/skills/arxiv/SKILL.md +275 -0
  14. package/.agent/skills/blogwatcher/SKILL.md +130 -0
  15. package/.agent/skills/code-wiki/SKILL.md +438 -0
  16. package/.agent/skills/code-wiki/templates/README.md +31 -0
  17. package/.agent/skills/code-wiki/templates/architecture.md +30 -0
  18. package/.agent/skills/code-wiki/templates/getting-started.md +47 -0
  19. package/.agent/skills/code-wiki/templates/module.md +38 -0
  20. package/.agent/skills/codebase-inspection/SKILL.md +109 -0
  21. package/.agent/skills/comic-creator/SKILL.md +240 -0
  22. package/.agent/skills/comic-creator/references/analysis-framework.md +176 -0
  23. package/.agent/skills/comic-creator/references/auto-selection.md +71 -0
  24. package/.agent/skills/comic-creator/references/base-prompt.md +98 -0
  25. package/.agent/skills/comic-creator/references/character-template.md +180 -0
  26. package/.agent/skills/comic-creator/references/ohmsha-guide.md +85 -0
  27. package/.agent/skills/comic-creator/references/partial-workflows.md +106 -0
  28. package/.agent/skills/comic-creator/references/storyboard-template.md +143 -0
  29. package/.agent/skills/comic-creator/references/workflow.md +401 -0
  30. package/.agent/skills/concept-diagrams/SKILL.md +355 -0
  31. package/.agent/skills/concept-diagrams/references/dashboard-patterns.md +43 -0
  32. package/.agent/skills/concept-diagrams/references/infrastructure-patterns.md +144 -0
  33. package/.agent/skills/concept-diagrams/references/physical-shape-cookbook.md +42 -0
  34. package/.agent/skills/creative-ideation/SKILL.md +144 -0
  35. package/.agent/skills/creative-ideation/references/full-prompt-library.md +110 -0
  36. package/.agent/skills/devops-cli/SKILL.md +149 -0
  37. package/.agent/skills/devops-cli/references/app-discovery.md +112 -0
  38. package/.agent/skills/devops-cli/references/authentication.md +59 -0
  39. package/.agent/skills/devops-cli/references/cli-reference.md +104 -0
  40. package/.agent/skills/devops-cli/references/running-apps.md +171 -0
  41. package/.agent/skills/devops-watchers/SKILL.md +103 -0
  42. package/.agent/skills/docker-management/SKILL.md +273 -0
  43. package/.agent/skills/domain-intel/SKILL.md +96 -0
  44. package/.agent/skills/duckduckgo-search/SKILL.md +230 -0
  45. package/.agent/skills/github-auth/SKILL.md +240 -0
  46. package/.agent/skills/github-code-review/SKILL.md +474 -0
  47. package/.agent/skills/github-code-review/references/review-output-template.md +74 -0
  48. package/.agent/skills/github-issues/SKILL.md +363 -0
  49. package/.agent/skills/github-issues/templates/bug-report.md +35 -0
  50. package/.agent/skills/github-issues/templates/feature-request.md +31 -0
  51. package/.agent/skills/github-pr-workflow/SKILL.md +360 -0
  52. package/.agent/skills/github-pr-workflow/references/ci-troubleshooting.md +183 -0
  53. package/.agent/skills/github-pr-workflow/references/conventional-commits.md +71 -0
  54. package/.agent/skills/github-pr-workflow/templates/pr-body-bugfix.md +35 -0
  55. package/.agent/skills/github-pr-workflow/templates/pr-body-feature.md +33 -0
  56. package/.agent/skills/github-repo-management/SKILL.md +509 -0
  57. package/.agent/skills/github-repo-management/references/github-api-cheatsheet.md +161 -0
  58. package/.agent/skills/godmode/SKILL.md +396 -0
  59. package/.agent/skills/godmode/references/jailbreak-templates.md +128 -0
  60. package/.agent/skills/godmode/references/refusal-detection.md +142 -0
  61. package/.agent/skills/hyperframes/SKILL.md +182 -0
  62. package/.agent/skills/hyperframes/references/cli.md +185 -0
  63. package/.agent/skills/hyperframes/references/composition.md +129 -0
  64. package/.agent/skills/hyperframes/references/features.md +289 -0
  65. package/.agent/skills/hyperframes/references/gsap.md +136 -0
  66. package/.agent/skills/hyperframes/references/troubleshooting.md +137 -0
  67. package/.agent/skills/hyperframes/references/website-to-video.md +145 -0
  68. package/.agent/skills/jupyter-live-kernel/SKILL.md +160 -0
  69. package/.agent/skills/kanban-orchestrator/SKILL.md +209 -0
  70. package/.agent/skills/kanban-worker/SKILL.md +188 -0
  71. package/.agent/skills/llm-wiki/SKILL.md +499 -0
  72. package/.agent/skills/meme-generation/SKILL.md +122 -0
  73. package/.agent/skills/node-inspect-debugger/SKILL.md +312 -0
  74. package/.agent/skills/obsidian/SKILL.md +60 -0
  75. package/.agent/skills/osint-investigation/SKILL.md +269 -0
  76. package/.agent/skills/osint-investigation/templates/source-template.md +59 -0
  77. package/.agent/skills/oss-forensics/SKILL.md +422 -0
  78. package/.agent/skills/oss-forensics/references/evidence-types.md +89 -0
  79. package/.agent/skills/oss-forensics/references/github-archive-guide.md +184 -0
  80. package/.agent/skills/oss-forensics/references/investigation-templates.md +131 -0
  81. package/.agent/skills/oss-forensics/references/recovery-techniques.md +164 -0
  82. package/.agent/skills/oss-forensics/templates/forensic-report.md +151 -0
  83. package/.agent/skills/oss-forensics/templates/malicious-package-report.md +43 -0
  84. package/.agent/skills/parallel-cli/SKILL.md +384 -0
  85. package/.agent/skills/pinggy-tunnel/SKILL.md +302 -0
  86. package/.agent/skills/pixel-art/SKILL.md +209 -0
  87. package/.agent/skills/pixel-art/references/palettes.md +49 -0
  88. package/.agent/skills/plan/SKILL.md +331 -0
  89. package/.agent/skills/polymarket/SKILL.md +75 -0
  90. package/.agent/skills/polymarket/references/api-endpoints.md +220 -0
  91. package/.agent/skills/python-debugpy/SKILL.md +368 -0
  92. package/.agent/skills/requesting-code-review/SKILL.md +273 -0
  93. package/.agent/skills/research-paper-writing/SKILL.md +2367 -0
  94. package/.agent/skills/research-paper-writing/references/autoreason-methodology.md +394 -0
  95. package/.agent/skills/research-paper-writing/references/checklists.md +434 -0
  96. package/.agent/skills/research-paper-writing/references/citation-workflow.md +563 -0
  97. package/.agent/skills/research-paper-writing/references/experiment-patterns.md +728 -0
  98. package/.agent/skills/research-paper-writing/references/human-evaluation.md +476 -0
  99. package/.agent/skills/research-paper-writing/references/paper-types.md +481 -0
  100. package/.agent/skills/research-paper-writing/references/reviewer-guidelines.md +433 -0
  101. package/.agent/skills/research-paper-writing/references/sources.md +191 -0
  102. package/.agent/skills/research-paper-writing/references/writing-guide.md +474 -0
  103. package/.agent/skills/research-paper-writing/templates/README.md +251 -0
  104. package/.agent/skills/rest-graphql-debug/SKILL.md +507 -0
  105. package/.agent/skills/s6-container-supervision/SKILL.md +171 -0
  106. package/.agent/skills/scrapling/SKILL.md +328 -0
  107. package/.agent/skills/sherlock/SKILL.md +186 -0
  108. package/.agent/skills/simplify-code/SKILL.md +168 -0
  109. package/.agent/skills/skill-authoring/SKILL.md +158 -0
  110. package/.agent/skills/spike/SKILL.md +190 -0
  111. package/.agent/skills/subagent-driven-development/SKILL.md +345 -0
  112. package/.agent/skills/subagent-driven-development/references/context-budget-discipline.md +53 -0
  113. package/.agent/skills/subagent-driven-development/references/gates-taxonomy.md +93 -0
  114. package/.agent/skills/systematic-debugging/SKILL.md +360 -0
  115. package/.agent/skills/test-driven-development/SKILL.md +336 -0
  116. package/.agent/skills/video-orchestrator/SKILL.md +194 -0
  117. package/.agent/skills/video-orchestrator/references/examples.md +227 -0
  118. package/.agent/skills/video-orchestrator/references/intake.md +166 -0
  119. package/.agent/skills/video-orchestrator/references/kanban-setup.md +278 -0
  120. package/.agent/skills/video-orchestrator/references/monitoring.md +180 -0
  121. package/.agent/skills/video-orchestrator/references/role-archetypes.md +298 -0
  122. package/.agent/skills/video-orchestrator/references/tool-matrix.md +317 -0
  123. package/.agent/skills/web-pentest/SKILL.md +332 -0
  124. package/.agent/skills/web-pentest/references/bypass-techniques.md +133 -0
  125. package/.agent/skills/web-pentest/references/exploitation-techniques.md +204 -0
  126. package/.agent/skills/web-pentest/references/scope-enforcement.md +110 -0
  127. package/.agent/skills/web-pentest/references/vuln-taxonomy.md +81 -0
  128. package/.agent/skills/web-pentest/templates/authorization.md +69 -0
  129. package/.agent/skills/web-pentest/templates/pentest-report.md +178 -0
  130. package/.claude/commands/mindforge/skill-tdd.md +53 -0
  131. package/.claude/commands/mindforge/skills-index.md +118 -0
  132. package/.claude/commands/mindforge/systematic-debug.md +60 -0
  133. package/.mindforge/config.json +2 -2
  134. package/.mindforge/memory/sync-manifest.json +1 -1
  135. package/.mindforge/skills/arxiv/SKILL.md +294 -0
  136. package/.mindforge/skills/blogwatcher/SKILL.md +147 -0
  137. package/.mindforge/skills/code-wiki/SKILL.md +457 -0
  138. package/.mindforge/skills/codebase-inspection/SKILL.md +126 -0
  139. package/.mindforge/skills/concept-diagrams/SKILL.md +373 -0
  140. package/.mindforge/skills/creative-ideation/SKILL.md +162 -0
  141. package/.mindforge/skills/domain-intel/SKILL.md +116 -0
  142. package/.mindforge/skills/duckduckgo-search/SKILL.md +249 -0
  143. package/.mindforge/skills/github-code-review/SKILL.md +493 -0
  144. package/.mindforge/skills/github-issues/SKILL.md +382 -0
  145. package/.mindforge/skills/github-pr-workflow/SKILL.md +379 -0
  146. package/.mindforge/skills/jupyter-live-kernel/SKILL.md +179 -0
  147. package/.mindforge/skills/kanban-orchestrator/SKILL.md +227 -0
  148. package/.mindforge/skills/kanban-worker/SKILL.md +206 -0
  149. package/.mindforge/skills/meme-generation/SKILL.md +141 -0
  150. package/.mindforge/skills/obsidian/SKILL.md +80 -0
  151. package/.mindforge/skills/osint-investigation/SKILL.md +288 -0
  152. package/.mindforge/skills/oss-forensics/SKILL.md +421 -0
  153. package/.mindforge/skills/pixel-art/SKILL.md +228 -0
  154. package/.mindforge/skills/plan/SKILL.md +350 -0
  155. package/.mindforge/skills/requesting-code-review/SKILL.md +292 -0
  156. package/.mindforge/skills/research-paper-writing/SKILL.md +2384 -0
  157. package/.mindforge/skills/scrapling/SKILL.md +345 -0
  158. package/.mindforge/skills/sherlock/SKILL.md +203 -0
  159. package/.mindforge/skills/simplify-code/SKILL.md +187 -0
  160. package/.mindforge/skills/spike/SKILL.md +209 -0
  161. package/.mindforge/skills/subagent-driven-development/SKILL.md +364 -0
  162. package/.mindforge/skills/systematic-debugging/SKILL.md +379 -0
  163. package/.mindforge/skills/test-driven-development/SKILL.md +355 -0
  164. package/.mindforge/skills/web-pentest/SKILL.md +327 -0
  165. package/CHANGELOG.md +43 -0
  166. package/MINDFORGE.md +2 -2
  167. package/README.md +39 -3
  168. package/RELEASENOTES.md +55 -0
  169. package/docs/getting-started.md +42 -5
  170. package/package.json +1 -1
@@ -0,0 +1,144 @@
1
+ ---
2
+ name: ideation
3
+ title: Creative Ideation — Constraint-Driven Project Generation
4
+ description: "Generate project ideas via creative constraints."
5
+ version: 1.0.0
6
+ ---
7
+
8
+ # Creative Ideation
9
+
10
+ ## When to use
11
+
12
+ Use when the user says 'I want to build something', 'give me a project idea', 'I'm bored', 'what should I make', 'inspire me', or any variant of 'I have tools but no direction'. Works for code, art, hardware, writing, tools, and anything that can be made.
13
+
14
+ Generate project ideas through creative constraints. Constraint + direction = creativity.
15
+
16
+ ## How It Works
17
+
18
+ 1. **Pick a constraint** from the library below — random, or matched to the user's domain/mood
19
+ 2. **Interpret it broadly** — a coding prompt can become a hardware project, an art prompt can become a CLI tool
20
+ 3. **Generate 3 concrete project ideas** that satisfy the constraint
21
+ 4. **If they pick one, build it** — create the project, write the code, ship it
22
+
23
+ ## The Rule
24
+
25
+ Every prompt is interpreted as broadly as possible. "Does this include X?" → Yes. The prompts provide direction and mild constraint. Without either, there is no creativity.
26
+
27
+ ## Constraint Library
28
+
29
+ ### For Developers
30
+
31
+ **Solve your own itch:**
32
+ Build the tool you wished existed this week. Under 50 lines. Ship it today.
33
+
34
+ **Automate the annoying thing:**
35
+ What's the most tedious part of your workflow? Script it away. Two hours to fix a problem that costs you five minutes a day.
36
+
37
+ **The CLI tool that should exist:**
38
+ Think of a command you've wished you could type. `git undo-that-thing-i-just-did`. `docker why-is-this-broken`. `npm explain-yourself`. Now build it.
39
+
40
+ **Nothing new except glue:**
41
+ Make something entirely from existing APIs, libraries, and datasets. The only original contribution is how you connect them.
42
+
43
+ **Frankenstein week:**
44
+ Take something that does X and make it do Y. A git repo that plays music. A Dockerfile that generates poetry. A cron job that sends compliments.
45
+
46
+ **Subtract:**
47
+ How much can you remove from a codebase before it breaks? Strip a tool to its minimum viable function. Delete until only the essence remains.
48
+
49
+ **High concept, low effort:**
50
+ A deep idea, lazily executed. The concept should be brilliant. The implementation should take an afternoon. If it takes longer, you're overthinking it.
51
+
52
+ ### For Makers & Artists
53
+
54
+ **Blatantly copy something:**
55
+ Pick something you admire — a tool, an artwork, an interface. Recreate it from scratch. The learning is in the gap between your version and theirs.
56
+
57
+ **One million of something:**
58
+ One million is both a lot and not that much. One million pixels is a 1MB photo. One million API calls is a Tuesday. One million of anything becomes interesting at scale.
59
+
60
+ **Make something that dies:**
61
+ A website that loses a feature every day. A chatbot that forgets. A countdown to nothing. An exercise in rot, killing, or letting go.
62
+
63
+ **Do a lot of math:**
64
+ Generative geometry, shader golf, mathematical art, computational origami. Time to re-learn what an arcsin is.
65
+
66
+ ### For Anyone
67
+
68
+ **Text is the universal interface:**
69
+ Build something where text is the only interface. No buttons, no graphics, just words in and words out. Text can go in and out of almost anything.
70
+
71
+ **Start at the punchline:**
72
+ Think of something that would be a funny sentence. Work backwards to make it real. "I taught my thermostat to gaslight me" → now build it.
73
+
74
+ **Hostile UI:**
75
+ Make something intentionally painful to use. A password field that requires 47 conditions. A form where every label lies. A CLI that judges your commands.
76
+
77
+ **Take two:**
78
+ Remember an old project. Do it again from scratch. No looking at the original. See what changed about how you think.
79
+
80
+ See `references/full-prompt-library.md` for 30+ additional constraints across communication, scale, philosophy, transformation, and more.
81
+
82
+ ## Matching Constraints to Users
83
+
84
+ | User says | Pick from |
85
+ |-----------|-----------|
86
+ | "I want to build something" (no direction) | Random — any constraint |
87
+ | "I'm learning [language]" | Blatantly copy something, Automate the annoying thing |
88
+ | "I want something weird" | Hostile UI, Frankenstein week, Start at the punchline |
89
+ | "I want something useful" | Solve your own itch, The CLI that should exist, Automate the annoying thing |
90
+ | "I want something beautiful" | Do a lot of math, One million of something |
91
+ | "I'm burned out" | High concept low effort, Make something that dies |
92
+ | "Weekend project" | Nothing new except glue, Start at the punchline |
93
+ | "I want a challenge" | One million of something, Subtract, Take two |
94
+
95
+ ## Output Format
96
+
97
+ ```
98
+ ## Constraint: [Name]
99
+ > [The constraint, one sentence]
100
+
101
+ ### Ideas
102
+
103
+ 1. **[One-line pitch]**
104
+ [2-3 sentences: what you'd build and why it's interesting]
105
+ ⏱ [weekend / week / month] • 🔧 [stack]
106
+
107
+ 2. **[One-line pitch]**
108
+ [2-3 sentences]
109
+ ⏱ ... • 🔧 ...
110
+
111
+ 3. **[One-line pitch]**
112
+ [2-3 sentences]
113
+ ⏱ ... • 🔧 ...
114
+ ```
115
+
116
+ ## Example
117
+
118
+ ```
119
+ ## Constraint: The CLI tool that should exist
120
+ > Think of a command you've wished you could type. Now build it.
121
+
122
+ ### Ideas
123
+
124
+ 1. **`git whatsup` — show what happened while you were away**
125
+ Compares your last active commit to HEAD and summarizes what changed,
126
+ who committed, and what PRs merged. Like a morning standup from your repo.
127
+ ⏱ weekend • 🔧 Python, GitPython, click
128
+
129
+ 2. **`explain 503` — HTTP status codes for humans**
130
+ Pipe any status code or error message and get a plain-English explanation
131
+ with common causes and fixes. Pulls from a curated database, not an LLM.
132
+ ⏱ weekend • 🔧 Rust or Go, static dataset
133
+
134
+ 3. **`deps why <package>` — why is this in my dependency tree**
135
+ Traces a transitive dependency back to the direct dependency that pulled
136
+ it in. Answers "why do I have 47 copies of lodash" in one command.
137
+ ⏱ weekend • 🔧 Node.js, npm/yarn lockfile parsing
138
+ ```
139
+
140
+ After the user picks one, start building — create the project, write the code, iterate.
141
+
142
+ ## Attribution
143
+
144
+ Constraint approach inspired by [wttdotm.com/prompts.html](https://wttdotm.com/prompts.html). Adapted and expanded for software development and general-purpose ideation.
@@ -0,0 +1,110 @@
1
+ # Full Prompt Library
2
+
3
+ Extended constraint library beyond the core set in SKILL.md. Load these when the user wants more variety or a specific category.
4
+
5
+ ## Communication & Connection
6
+
7
+ **Create a means of distribution:**
8
+ The project works when you can use what you made to give something to somebody else.
9
+
10
+ **Make a way to communicate:**
11
+ The project works when you can hold a conversation with someone else using what you created. Not chat — something weirder.
12
+
13
+ **Write a love letter:**
14
+ To a person, a programming language, a game, a place, a tool. On paper, in code, in music, in light. Mail it.
15
+
16
+ **Mail chess / Asynchronous games:**
17
+ Something turn-based played with no time limit. No requirement to be there at the same time. The game happens in the gaps.
18
+
19
+ **Twitch plays X:**
20
+ A group of people share control over something. Collective input, emergent behavior.
21
+
22
+ ## Screens & Interfaces
23
+
24
+ **Something for your desktop:**
25
+ You spend a lot of time there. Spruce it up. A custom clock, a pet that lives in your terminal, a wallpaper that changes based on your git activity.
26
+
27
+ **One screen, two screen, old screen, new screen:**
28
+ Take something you associate with one screen and put it on a very different one. DOOM on a smart fridge. A spreadsheet on a watch. A terminal in a painting.
29
+
30
+ **Make a mirror:**
31
+ Something that reflects the viewer back at themselves. A website that shows your browsing history. A CLI that prints your git sins.
32
+
33
+ ## Philosophy & Concept
34
+
35
+ **Code as koan, koan as code:**
36
+ What is the sound of one hand clapping? A program that answers a question it wasn't asked. A function that returns before it's called.
37
+
38
+ **The useless tree:**
39
+ Make something useless. Deliberately, completely, beautifully useless. No utility. No purpose. No point. That's the point.
40
+
41
+ **Artificial stupidity:**
42
+ Make fun of AI by showcasing its faults. Mistrain it. Lie to it. Build the opposite of what AI is supposed to be good at.
43
+
44
+ **"I use technology in order to hate it properly":**
45
+ Make something inspired by the tension between loving and hating your tools.
46
+
47
+ **The more things change, the more they stay the same:**
48
+ Reflect on time, difference, and similarity.
49
+
50
+ ## Transformation
51
+
52
+ **Translate:**
53
+ Take something meant for one audience and make it understandable by another. A research paper as a children's book. An API as a board game. A song as an architecture diagram.
54
+
55
+ **I mean, I GUESS you could store something that way:**
56
+ The project works when you can save and open something. Store data in DNS caches. Encode a novel in emoji. Write a file system on top of something that isn't a file system.
57
+
58
+ **I mean, I GUESS those could be pixels:**
59
+ The project works when you can display an image. Render anything visual in a medium that wasn't meant for rendering.
60
+
61
+ ## Identity & Reflection
62
+
63
+ **Make a self-portrait:**
64
+ Be yourself? Be fake? Be real? In code, in data, in sound, in a directory structure.
65
+
66
+ **Make a pun:**
67
+ The stupider the better. Physical, digital, linguistic, visual. The project IS the joke.
68
+
69
+ **Doors, walls, borders, barriers, boundaries:**
70
+ Things that intermediate two places: opening, closing, permeating, excluding, combining.
71
+
72
+ ## Scale & Repetition
73
+
74
+ **Lists!:**
75
+ Itemizations, taxonomies, exhaustive recountings, iterations. This one. A list of list of lists.
76
+
77
+ **Did you mean *recursion*?**
78
+ Did you mean recursion?
79
+
80
+ **Animals:**
81
+ Lions, and tigers, and bears. Crab logic gates. Fish plays the stock market.
82
+
83
+ **Cats:**
84
+ Where would the internet be without them.
85
+
86
+ ## Starting Points
87
+
88
+ **An idea that comes from a book:**
89
+ Read something. Make something inspired by it.
90
+
91
+ **Go to a museum:**
92
+ Project ensues.
93
+
94
+ **NPC loot:**
95
+ What do you drop when you die? What do you take on your journey? Build the item.
96
+
97
+ **Mythological objects and entities:**
98
+ Pandora's box, the ocarina of time, the palantir. Build the artifact.
99
+
100
+ **69:**
101
+ Nice. Make something with the joke being the number 69.
102
+
103
+ **Office Space printer scene:**
104
+ Capture the same energy. Channel the catharsis of destroying the thing that frustrates you.
105
+
106
+ **Borges week:**
107
+ Something inspired by the Argentine. The library of babel. The map that is the territory.
108
+
109
+ **Lights!:**
110
+ LED throwies, light installations, illuminated anything. Make something that glows.
@@ -0,0 +1,149 @@
1
+ ---
2
+ name: inference-sh-cli
3
+ description: "Run 150+ AI apps via inference.sh CLI (infsh) — image generation, video creation, LLMs, search, 3D, social automation. Uses the terminal tool. Triggers: inference.sh, infsh, ai apps, flux, veo, image generation, video generation, seedream, seedance, tavily"
4
+ version: 1.0.0
5
+ ---
6
+
7
+ # inference.sh CLI
8
+
9
+ Run 150+ AI apps in the cloud with a simple CLI. No GPU required.
10
+
11
+ All commands use the **terminal tool** to run `infsh` commands.
12
+
13
+ ## When to Use
14
+
15
+ - User asks to generate images (FLUX, Reve, Seedream, Grok, Gemini image)
16
+ - User asks to generate video (Veo, Wan, Seedance, OmniHuman)
17
+ - User asks about inference.sh or infsh
18
+ - User wants to run AI apps without managing individual provider APIs
19
+ - User asks for AI-powered search (Tavily, Exa)
20
+ - User needs avatar/lipsync generation
21
+
22
+ ## Prerequisites
23
+
24
+ The `infsh` CLI must be installed and authenticated. Check with:
25
+
26
+ ```bash
27
+ infsh me
28
+ ```
29
+
30
+ If not installed:
31
+
32
+ ```bash
33
+ curl -fsSL https://cli.inference.sh | sh
34
+ infsh login
35
+ ```
36
+
37
+ See `references/authentication.md` for full setup details.
38
+
39
+ ## Workflow
40
+
41
+ ### 1. Always Search First
42
+
43
+ Never guess app names — always search to find the correct app ID:
44
+
45
+ ```bash
46
+ infsh app list --search flux
47
+ infsh app list --search video
48
+ infsh app list --search image
49
+ ```
50
+
51
+ ### 2. Run an App
52
+
53
+ Use the exact app ID from the search results. Always use `--json` for machine-readable output:
54
+
55
+ ```bash
56
+ infsh app run <app-id> --input '{"prompt": "your prompt here"}' --json
57
+ ```
58
+
59
+ ### 3. Parse the Output
60
+
61
+ The JSON output contains URLs to generated media. Present these to the user with `MEDIA:<url>` for inline display.
62
+
63
+ ## Common Commands
64
+
65
+ ### Image Generation
66
+
67
+ ```bash
68
+ # Search for image apps
69
+ infsh app list --search image
70
+
71
+ # FLUX Dev with LoRA
72
+ infsh app run falai/flux-dev-lora --input '{"prompt": "sunset over mountains", "num_images": 1}' --json
73
+
74
+ # Gemini image generation
75
+ infsh app run google/gemini-2-5-flash-image --input '{"prompt": "futuristic city", "num_images": 1}' --json
76
+
77
+ # Seedream (ByteDance)
78
+ infsh app run bytedance/seedream-5-lite --input '{"prompt": "nature scene"}' --json
79
+
80
+ # Grok Imagine (xAI)
81
+ infsh app run xai/grok-imagine-image --input '{"prompt": "abstract art"}' --json
82
+ ```
83
+
84
+ ### Video Generation
85
+
86
+ ```bash
87
+ # Search for video apps
88
+ infsh app list --search video
89
+
90
+ # Veo 3.1 (Google)
91
+ infsh app run google/veo-3-1-fast --input '{"prompt": "drone shot of coastline"}' --json
92
+
93
+ # Seedance (ByteDance)
94
+ infsh app run bytedance/seedance-1-5-pro --input '{"prompt": "dancing figure", "resolution": "1080p"}' --json
95
+
96
+ # Wan 2.5
97
+ infsh app run falai/wan-2-5 --input '{"prompt": "person walking through city"}' --json
98
+ ```
99
+
100
+ ### Local File Uploads
101
+
102
+ The CLI automatically uploads local files when you provide a path:
103
+
104
+ ```bash
105
+ # Upscale a local image
106
+ infsh app run falai/topaz-image-upscaler --input '{"image": "/path/to/photo.jpg", "upscale_factor": 2}' --json
107
+
108
+ # Image-to-video from local file
109
+ infsh app run falai/wan-2-5-i2v --input '{"image": "/path/to/image.png", "prompt": "make it move"}' --json
110
+
111
+ # Avatar with audio
112
+ infsh app run bytedance/omnihuman-1-5 --input '{"audio": "/path/to/audio.mp3", "image": "/path/to/face.jpg"}' --json
113
+ ```
114
+
115
+ ### Search & Research
116
+
117
+ ```bash
118
+ infsh app list --search search
119
+ infsh app run tavily/tavily-search --input '{"query": "latest AI news"}' --json
120
+ infsh app run exa/exa-search --input '{"query": "machine learning papers"}' --json
121
+ ```
122
+
123
+ ### Other Categories
124
+
125
+ ```bash
126
+ # 3D generation
127
+ infsh app list --search 3d
128
+
129
+ # Audio / TTS
130
+ infsh app list --search tts
131
+
132
+ # Twitter/X automation
133
+ infsh app list --search twitter
134
+ ```
135
+
136
+ ## Pitfalls
137
+
138
+ 1. **Never guess app IDs** — always run `infsh app list --search <term>` first. App IDs change and new apps are added frequently.
139
+ 2. **Always use `--json`** — raw output is hard to parse. The `--json` flag gives structured output with URLs.
140
+ 3. **Check authentication** — if commands fail with auth errors, run `infsh login` or verify `INFSH_API_KEY` is set.
141
+ 4. **Long-running apps** — video generation can take 30-120 seconds. The terminal tool timeout should be sufficient, but warn the user it may take a moment.
142
+ 5. **Input format** — the `--input` flag takes a JSON string. Make sure to properly escape quotes.
143
+
144
+ ## Reference Docs
145
+
146
+ - `references/authentication.md` — Setup, login, API keys
147
+ - `references/app-discovery.md` — Searching and browsing the app catalog
148
+ - `references/running-apps.md` — Running apps, input formats, output handling
149
+ - `references/cli-reference.md` — Complete CLI command reference
@@ -0,0 +1,112 @@
1
+ # Discovering Apps
2
+
3
+ ## List All Apps
4
+
5
+ ```bash
6
+ infsh app list
7
+ ```
8
+
9
+ ## Pagination
10
+
11
+ ```bash
12
+ infsh app list --page 2
13
+ ```
14
+
15
+ ## Filter by Category
16
+
17
+ ```bash
18
+ infsh app list --category image
19
+ infsh app list --category video
20
+ infsh app list --category audio
21
+ infsh app list --category text
22
+ infsh app list --category other
23
+ ```
24
+
25
+ ## Search
26
+
27
+ ```bash
28
+ infsh app search "flux"
29
+ infsh app search "video generation"
30
+ infsh app search "tts" -l
31
+ infsh app search "image" --category image
32
+ ```
33
+
34
+ Or use the flag form:
35
+
36
+ ```bash
37
+ infsh app list --search "flux"
38
+ infsh app list --search "video generation"
39
+ infsh app list --search "tts"
40
+ ```
41
+
42
+ ## Featured Apps
43
+
44
+ ```bash
45
+ infsh app list --featured
46
+ ```
47
+
48
+ ## Newest First
49
+
50
+ ```bash
51
+ infsh app list --new
52
+ ```
53
+
54
+ ## Detailed View
55
+
56
+ ```bash
57
+ infsh app list -l
58
+ ```
59
+
60
+ Shows table with app name, category, description, and featured status.
61
+
62
+ ## Save to File
63
+
64
+ ```bash
65
+ infsh app list --save apps.json
66
+ ```
67
+
68
+ ## Your Apps
69
+
70
+ List apps you've deployed:
71
+
72
+ ```bash
73
+ infsh app my
74
+ infsh app my -l # detailed
75
+ ```
76
+
77
+ ## Get App Details
78
+
79
+ ```bash
80
+ infsh app get falai/flux-dev-lora
81
+ infsh app get falai/flux-dev-lora --json
82
+ ```
83
+
84
+ Shows full app info including input/output schema.
85
+
86
+ ## Popular Apps by Category
87
+
88
+ ### Image Generation
89
+ - `falai/flux-dev-lora` - FLUX.2 Dev (high quality)
90
+ - `falai/flux-2-klein-lora` - FLUX.2 Klein (fastest)
91
+ - `infsh/sdxl` - Stable Diffusion XL
92
+ - `google/gemini-3-pro-image-preview` - Gemini 3 Pro
93
+ - `xai/grok-imagine-image` - Grok image generation
94
+
95
+ ### Video Generation
96
+ - `google/veo-3-1-fast` - Veo 3.1 Fast
97
+ - `google/veo-3` - Veo 3
98
+ - `bytedance/seedance-1-5-pro` - Seedance 1.5 Pro
99
+ - `infsh/ltx-video-2` - LTX Video 2 (with audio)
100
+ - `bytedance/omnihuman-1-5` - OmniHuman avatar
101
+
102
+ ### Audio
103
+ - `infsh/dia-tts` - Conversational TTS
104
+ - `infsh/kokoro-tts` - Kokoro TTS
105
+ - `infsh/fast-whisper-large-v3` - Fast transcription
106
+ - `infsh/diffrythm` - Music generation
107
+
108
+ ## Documentation
109
+
110
+ - [Browsing the Grid](https://inference.sh/docs/apps/browsing-grid) - Visual app browsing
111
+ - [Apps Overview](https://inference.sh/docs/apps/overview) - Understanding apps
112
+ - [Running Apps](https://inference.sh/docs/apps/running) - How to run apps
@@ -0,0 +1,59 @@
1
+ # Authentication & Setup
2
+
3
+ ## Install the CLI
4
+
5
+ ```bash
6
+ curl -fsSL https://cli.inference.sh | sh
7
+ ```
8
+
9
+ ## Login
10
+
11
+ ```bash
12
+ infsh login
13
+ ```
14
+
15
+ This opens a browser for authentication. After login, credentials are stored locally.
16
+
17
+ ## Check Authentication
18
+
19
+ ```bash
20
+ infsh me
21
+ ```
22
+
23
+ Shows your user info if authenticated.
24
+
25
+ ## Environment Variable
26
+
27
+ For CI/CD or scripts, set your API key:
28
+
29
+ ```bash
30
+ export INFSH_API_KEY=your-api-key
31
+ ```
32
+
33
+ The environment variable overrides the config file.
34
+
35
+ ## Update CLI
36
+
37
+ ```bash
38
+ infsh update
39
+ ```
40
+
41
+ Or reinstall:
42
+
43
+ ```bash
44
+ curl -fsSL https://cli.inference.sh | sh
45
+ ```
46
+
47
+ ## Troubleshooting
48
+
49
+ | Error | Solution |
50
+ |-------|----------|
51
+ | "not authenticated" | Run `infsh login` |
52
+ | "command not found" | Reinstall CLI or add to PATH |
53
+ | "API key invalid" | Check `INFSH_API_KEY` or re-login |
54
+
55
+ ## Documentation
56
+
57
+ - [CLI Setup](https://inference.sh/docs/extend/cli-setup) - Complete CLI installation guide
58
+ - [API Authentication](https://inference.sh/docs/api/authentication) - API key management
59
+ - [Secrets](https://inference.sh/docs/secrets/overview) - Managing credentials
@@ -0,0 +1,104 @@
1
+ # CLI Reference
2
+
3
+ ## Installation
4
+
5
+ ```bash
6
+ curl -fsSL https://cli.inference.sh | sh
7
+ ```
8
+
9
+ ## Global Commands
10
+
11
+ | Command | Description |
12
+ |---------|-------------|
13
+ | `infsh help` | Show help |
14
+ | `infsh version` | Show CLI version |
15
+ | `infsh update` | Update CLI to latest |
16
+ | `infsh login` | Authenticate |
17
+ | `infsh me` | Show current user |
18
+
19
+ ## App Commands
20
+
21
+ ### Discovery
22
+
23
+ | Command | Description |
24
+ |---------|-------------|
25
+ | `infsh app list` | List available apps |
26
+ | `infsh app list --category <cat>` | Filter by category (image, video, audio, text, other) |
27
+ | `infsh app search <query>` | Search apps |
28
+ | `infsh app list --search <query>` | Search apps (flag form) |
29
+ | `infsh app list --featured` | Show featured apps |
30
+ | `infsh app list --new` | Sort by newest |
31
+ | `infsh app list --page <n>` | Pagination |
32
+ | `infsh app list -l` | Detailed table view |
33
+ | `infsh app list --save <file>` | Save to JSON file |
34
+ | `infsh app my` | List your deployed apps |
35
+ | `infsh app get <app>` | Get app details |
36
+ | `infsh app get <app> --json` | Get app details as JSON |
37
+
38
+ ### Execution
39
+
40
+ | Command | Description |
41
+ |---------|-------------|
42
+ | `infsh app run <app> --input <file>` | Run app with input file |
43
+ | `infsh app run <app> --input '<json>'` | Run with inline JSON |
44
+ | `infsh app run <app> --input <file> --no-wait` | Run without waiting for completion |
45
+ | `infsh app sample <app>` | Show sample input |
46
+ | `infsh app sample <app> --save <file>` | Save sample to file |
47
+
48
+ ## Task Commands
49
+
50
+ | Command | Description |
51
+ |---------|-------------|
52
+ | `infsh task get <task-id>` | Get task status and result |
53
+ | `infsh task get <task-id> --json` | Get task as JSON |
54
+ | `infsh task get <task-id> --save <file>` | Save task result to file |
55
+
56
+ ### Development
57
+
58
+ | Command | Description |
59
+ |---------|-------------|
60
+ | `infsh app init` | Create new app (interactive) |
61
+ | `infsh app init <name>` | Create new app with name |
62
+ | `infsh app test --input <file>` | Test app locally |
63
+ | `infsh app deploy` | Deploy app |
64
+ | `infsh app deploy --dry-run` | Validate without deploying |
65
+ | `infsh app pull <id>` | Pull app source |
66
+ | `infsh app pull --all` | Pull all your apps |
67
+
68
+ ## Environment Variables
69
+
70
+ | Variable | Description |
71
+ |----------|-------------|
72
+ | `INFSH_API_KEY` | API key (overrides config) |
73
+
74
+ ## Shell Completions
75
+
76
+ ```bash
77
+ # Bash
78
+ infsh completion bash > /etc/bash_completion.d/infsh
79
+
80
+ # Zsh
81
+ infsh completion zsh > "${fpath[1]}/_infsh"
82
+
83
+ # Fish
84
+ infsh completion fish > ~/.config/fish/completions/infsh.fish
85
+ ```
86
+
87
+ ## App Name Format
88
+
89
+ Apps use the format `namespace/app-name`:
90
+
91
+ - `falai/flux-dev-lora` - fal.ai's FLUX 2 Dev
92
+ - `google/veo-3` - Google's Veo 3
93
+ - `infsh/sdxl` - inference.sh's SDXL
94
+ - `bytedance/seedance-1-5-pro` - ByteDance's Seedance
95
+ - `xai/grok-imagine-image` - xAI's Grok
96
+
97
+ Version pinning: `namespace/app-name@version`
98
+
99
+ ## Documentation
100
+
101
+ - [CLI Setup](https://inference.sh/docs/extend/cli-setup) - Complete CLI installation guide
102
+ - [Running Apps](https://inference.sh/docs/apps/running) - How to run apps via CLI
103
+ - [Creating an App](https://inference.sh/docs/extend/creating-app) - Build your own apps
104
+ - [Deploying](https://inference.sh/docs/extend/deploying) - Deploy apps to the cloud