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.
- package/.agent/mindforge/skill-tdd.md +53 -0
- package/.agent/mindforge/skills-index.md +118 -0
- package/.agent/mindforge/systematic-debug.md +60 -0
- package/.agent/skills/1password-skill/SKILL.md +156 -0
- package/.agent/skills/1password-skill/references/cli-examples.md +31 -0
- package/.agent/skills/1password-skill/references/get-started.md +21 -0
- package/.agent/skills/article-illustrator/SKILL.md +199 -0
- package/.agent/skills/article-illustrator/references/prompt-construction.md +426 -0
- package/.agent/skills/article-illustrator/references/style-presets.md +80 -0
- package/.agent/skills/article-illustrator/references/styles.md +224 -0
- package/.agent/skills/article-illustrator/references/usage.md +50 -0
- package/.agent/skills/article-illustrator/references/workflow.md +332 -0
- package/.agent/skills/arxiv/SKILL.md +275 -0
- package/.agent/skills/blogwatcher/SKILL.md +130 -0
- package/.agent/skills/code-wiki/SKILL.md +438 -0
- package/.agent/skills/code-wiki/templates/README.md +31 -0
- package/.agent/skills/code-wiki/templates/architecture.md +30 -0
- package/.agent/skills/code-wiki/templates/getting-started.md +47 -0
- package/.agent/skills/code-wiki/templates/module.md +38 -0
- package/.agent/skills/codebase-inspection/SKILL.md +109 -0
- package/.agent/skills/comic-creator/SKILL.md +240 -0
- package/.agent/skills/comic-creator/references/analysis-framework.md +176 -0
- package/.agent/skills/comic-creator/references/auto-selection.md +71 -0
- package/.agent/skills/comic-creator/references/base-prompt.md +98 -0
- package/.agent/skills/comic-creator/references/character-template.md +180 -0
- package/.agent/skills/comic-creator/references/ohmsha-guide.md +85 -0
- package/.agent/skills/comic-creator/references/partial-workflows.md +106 -0
- package/.agent/skills/comic-creator/references/storyboard-template.md +143 -0
- package/.agent/skills/comic-creator/references/workflow.md +401 -0
- package/.agent/skills/concept-diagrams/SKILL.md +355 -0
- package/.agent/skills/concept-diagrams/references/dashboard-patterns.md +43 -0
- package/.agent/skills/concept-diagrams/references/infrastructure-patterns.md +144 -0
- package/.agent/skills/concept-diagrams/references/physical-shape-cookbook.md +42 -0
- package/.agent/skills/creative-ideation/SKILL.md +144 -0
- package/.agent/skills/creative-ideation/references/full-prompt-library.md +110 -0
- package/.agent/skills/devops-cli/SKILL.md +149 -0
- package/.agent/skills/devops-cli/references/app-discovery.md +112 -0
- package/.agent/skills/devops-cli/references/authentication.md +59 -0
- package/.agent/skills/devops-cli/references/cli-reference.md +104 -0
- package/.agent/skills/devops-cli/references/running-apps.md +171 -0
- package/.agent/skills/devops-watchers/SKILL.md +103 -0
- package/.agent/skills/docker-management/SKILL.md +273 -0
- package/.agent/skills/domain-intel/SKILL.md +96 -0
- package/.agent/skills/duckduckgo-search/SKILL.md +230 -0
- package/.agent/skills/github-auth/SKILL.md +240 -0
- package/.agent/skills/github-code-review/SKILL.md +474 -0
- package/.agent/skills/github-code-review/references/review-output-template.md +74 -0
- package/.agent/skills/github-issues/SKILL.md +363 -0
- package/.agent/skills/github-issues/templates/bug-report.md +35 -0
- package/.agent/skills/github-issues/templates/feature-request.md +31 -0
- package/.agent/skills/github-pr-workflow/SKILL.md +360 -0
- package/.agent/skills/github-pr-workflow/references/ci-troubleshooting.md +183 -0
- package/.agent/skills/github-pr-workflow/references/conventional-commits.md +71 -0
- package/.agent/skills/github-pr-workflow/templates/pr-body-bugfix.md +35 -0
- package/.agent/skills/github-pr-workflow/templates/pr-body-feature.md +33 -0
- package/.agent/skills/github-repo-management/SKILL.md +509 -0
- package/.agent/skills/github-repo-management/references/github-api-cheatsheet.md +161 -0
- package/.agent/skills/godmode/SKILL.md +396 -0
- package/.agent/skills/godmode/references/jailbreak-templates.md +128 -0
- package/.agent/skills/godmode/references/refusal-detection.md +142 -0
- package/.agent/skills/hyperframes/SKILL.md +182 -0
- package/.agent/skills/hyperframes/references/cli.md +185 -0
- package/.agent/skills/hyperframes/references/composition.md +129 -0
- package/.agent/skills/hyperframes/references/features.md +289 -0
- package/.agent/skills/hyperframes/references/gsap.md +136 -0
- package/.agent/skills/hyperframes/references/troubleshooting.md +137 -0
- package/.agent/skills/hyperframes/references/website-to-video.md +145 -0
- package/.agent/skills/jupyter-live-kernel/SKILL.md +160 -0
- package/.agent/skills/kanban-orchestrator/SKILL.md +209 -0
- package/.agent/skills/kanban-worker/SKILL.md +188 -0
- package/.agent/skills/llm-wiki/SKILL.md +499 -0
- package/.agent/skills/meme-generation/SKILL.md +122 -0
- package/.agent/skills/node-inspect-debugger/SKILL.md +312 -0
- package/.agent/skills/obsidian/SKILL.md +60 -0
- package/.agent/skills/osint-investigation/SKILL.md +269 -0
- package/.agent/skills/osint-investigation/templates/source-template.md +59 -0
- package/.agent/skills/oss-forensics/SKILL.md +422 -0
- package/.agent/skills/oss-forensics/references/evidence-types.md +89 -0
- package/.agent/skills/oss-forensics/references/github-archive-guide.md +184 -0
- package/.agent/skills/oss-forensics/references/investigation-templates.md +131 -0
- package/.agent/skills/oss-forensics/references/recovery-techniques.md +164 -0
- package/.agent/skills/oss-forensics/templates/forensic-report.md +151 -0
- package/.agent/skills/oss-forensics/templates/malicious-package-report.md +43 -0
- package/.agent/skills/parallel-cli/SKILL.md +384 -0
- package/.agent/skills/pinggy-tunnel/SKILL.md +302 -0
- package/.agent/skills/pixel-art/SKILL.md +209 -0
- package/.agent/skills/pixel-art/references/palettes.md +49 -0
- package/.agent/skills/plan/SKILL.md +331 -0
- package/.agent/skills/polymarket/SKILL.md +75 -0
- package/.agent/skills/polymarket/references/api-endpoints.md +220 -0
- package/.agent/skills/python-debugpy/SKILL.md +368 -0
- package/.agent/skills/requesting-code-review/SKILL.md +273 -0
- package/.agent/skills/research-paper-writing/SKILL.md +2367 -0
- package/.agent/skills/research-paper-writing/references/autoreason-methodology.md +394 -0
- package/.agent/skills/research-paper-writing/references/checklists.md +434 -0
- package/.agent/skills/research-paper-writing/references/citation-workflow.md +563 -0
- package/.agent/skills/research-paper-writing/references/experiment-patterns.md +728 -0
- package/.agent/skills/research-paper-writing/references/human-evaluation.md +476 -0
- package/.agent/skills/research-paper-writing/references/paper-types.md +481 -0
- package/.agent/skills/research-paper-writing/references/reviewer-guidelines.md +433 -0
- package/.agent/skills/research-paper-writing/references/sources.md +191 -0
- package/.agent/skills/research-paper-writing/references/writing-guide.md +474 -0
- package/.agent/skills/research-paper-writing/templates/README.md +251 -0
- package/.agent/skills/rest-graphql-debug/SKILL.md +507 -0
- package/.agent/skills/s6-container-supervision/SKILL.md +171 -0
- package/.agent/skills/scrapling/SKILL.md +328 -0
- package/.agent/skills/sherlock/SKILL.md +186 -0
- package/.agent/skills/simplify-code/SKILL.md +168 -0
- package/.agent/skills/skill-authoring/SKILL.md +158 -0
- package/.agent/skills/spike/SKILL.md +190 -0
- package/.agent/skills/subagent-driven-development/SKILL.md +345 -0
- package/.agent/skills/subagent-driven-development/references/context-budget-discipline.md +53 -0
- package/.agent/skills/subagent-driven-development/references/gates-taxonomy.md +93 -0
- package/.agent/skills/systematic-debugging/SKILL.md +360 -0
- package/.agent/skills/test-driven-development/SKILL.md +336 -0
- package/.agent/skills/video-orchestrator/SKILL.md +194 -0
- package/.agent/skills/video-orchestrator/references/examples.md +227 -0
- package/.agent/skills/video-orchestrator/references/intake.md +166 -0
- package/.agent/skills/video-orchestrator/references/kanban-setup.md +278 -0
- package/.agent/skills/video-orchestrator/references/monitoring.md +180 -0
- package/.agent/skills/video-orchestrator/references/role-archetypes.md +298 -0
- package/.agent/skills/video-orchestrator/references/tool-matrix.md +317 -0
- package/.agent/skills/web-pentest/SKILL.md +332 -0
- package/.agent/skills/web-pentest/references/bypass-techniques.md +133 -0
- package/.agent/skills/web-pentest/references/exploitation-techniques.md +204 -0
- package/.agent/skills/web-pentest/references/scope-enforcement.md +110 -0
- package/.agent/skills/web-pentest/references/vuln-taxonomy.md +81 -0
- package/.agent/skills/web-pentest/templates/authorization.md +69 -0
- package/.agent/skills/web-pentest/templates/pentest-report.md +178 -0
- package/.claude/commands/mindforge/skill-tdd.md +53 -0
- package/.claude/commands/mindforge/skills-index.md +118 -0
- package/.claude/commands/mindforge/systematic-debug.md +60 -0
- package/.mindforge/config.json +2 -2
- package/.mindforge/memory/sync-manifest.json +1 -1
- package/.mindforge/skills/arxiv/SKILL.md +294 -0
- package/.mindforge/skills/blogwatcher/SKILL.md +147 -0
- package/.mindforge/skills/code-wiki/SKILL.md +457 -0
- package/.mindforge/skills/codebase-inspection/SKILL.md +126 -0
- package/.mindforge/skills/concept-diagrams/SKILL.md +373 -0
- package/.mindforge/skills/creative-ideation/SKILL.md +162 -0
- package/.mindforge/skills/domain-intel/SKILL.md +116 -0
- package/.mindforge/skills/duckduckgo-search/SKILL.md +249 -0
- package/.mindforge/skills/github-code-review/SKILL.md +493 -0
- package/.mindforge/skills/github-issues/SKILL.md +382 -0
- package/.mindforge/skills/github-pr-workflow/SKILL.md +379 -0
- package/.mindforge/skills/jupyter-live-kernel/SKILL.md +179 -0
- package/.mindforge/skills/kanban-orchestrator/SKILL.md +227 -0
- package/.mindforge/skills/kanban-worker/SKILL.md +206 -0
- package/.mindforge/skills/meme-generation/SKILL.md +141 -0
- package/.mindforge/skills/obsidian/SKILL.md +80 -0
- package/.mindforge/skills/osint-investigation/SKILL.md +288 -0
- package/.mindforge/skills/oss-forensics/SKILL.md +421 -0
- package/.mindforge/skills/pixel-art/SKILL.md +228 -0
- package/.mindforge/skills/plan/SKILL.md +350 -0
- package/.mindforge/skills/requesting-code-review/SKILL.md +292 -0
- package/.mindforge/skills/research-paper-writing/SKILL.md +2384 -0
- package/.mindforge/skills/scrapling/SKILL.md +345 -0
- package/.mindforge/skills/sherlock/SKILL.md +203 -0
- package/.mindforge/skills/simplify-code/SKILL.md +187 -0
- package/.mindforge/skills/spike/SKILL.md +209 -0
- package/.mindforge/skills/subagent-driven-development/SKILL.md +364 -0
- package/.mindforge/skills/systematic-debugging/SKILL.md +379 -0
- package/.mindforge/skills/test-driven-development/SKILL.md +355 -0
- package/.mindforge/skills/web-pentest/SKILL.md +327 -0
- package/CHANGELOG.md +43 -0
- package/MINDFORGE.md +2 -2
- package/README.md +39 -3
- package/RELEASENOTES.md +55 -0
- package/docs/getting-started.md +42 -5
- 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
|