superacli 1.1.20 → 1.1.21

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 (125) hide show
  1. package/cli/adapter-schema.js +1 -6
  2. package/cli/config.js +95 -0
  3. package/cli/executor.js +90 -11
  4. package/cli/server-command.js +395 -0
  5. package/cli/supercli.js +82 -1
  6. package/docs/adapters.md +159 -0
  7. package/docs/changelog-2026-04.html +15 -0
  8. package/docs/index.html +314 -98
  9. package/docs/meta-plugins.json +24424 -1247
  10. package/docs/plugins-examples.md +8 -8
  11. package/docs/plugins-how-to.md +0 -13
  12. package/docs/plugins.html +165 -61
  13. package/docs/server.md +50 -0
  14. package/graphify-out/GRAPH_REPORT.md +141 -136
  15. package/graphify-out/cache/1821936911d6eb3130499b6b45b8e6d760d6c05328131e115ac9825a5e3061cd.json +1 -0
  16. package/graphify-out/cache/20b0e1261b41286d639e7b039c8143682001981f607e26eb2a492a06f12c233a.json +1 -0
  17. package/graphify-out/cache/21dc011c08a0813ac33c0520c9cf131d8922e6007df7d9b51df740974fee5fb3.json +1 -0
  18. package/graphify-out/cache/22d3d43c24fdff310ab8445bd442fbcf4714872c6950f15b90777e5a8358dcd9.json +1 -0
  19. package/graphify-out/cache/2b8a3fbc23afe7bbc1a5ecb60d4074f39afdf6cb42120922176c280f4cc4ab4b.json +1 -0
  20. package/graphify-out/cache/37418b8b152d9c436d75361969c39bc74a76260ab7209ceabf455f80452f1654.json +1 -0
  21. package/graphify-out/cache/3b9aae57e4326f5862f8153c13b7d809a34c422996993e7b491c5ea3a66b5e04.json +1 -0
  22. package/graphify-out/cache/448f8e0c5e77cfb15fa625ed40ee0dc1622d9814d24905fe4c12c4d175131dc9.json +1 -0
  23. package/graphify-out/cache/47dd42009ceac28b7a7fec5586e565e7bc850c80be96b8329e1ed7c49efbe34f.json +1 -0
  24. package/graphify-out/cache/492712949d38efbe312c303fe717e5c93e1ecc8888e1ceb855750afc48caffdb.json +1 -0
  25. package/graphify-out/cache/494fd6af80b6a1bb7a2a5641c6ad11e2fbe2a67b5a2b3ff57fd04bb49ccad1c4.json +1 -0
  26. package/graphify-out/cache/4b31b0de656deff083119780df64d17205c45e72233987e1c495f2121c4923fd.json +1 -0
  27. package/graphify-out/cache/5a16fa8cdd687a39661321adb39186ce8cf924a79ef936e42b365380b5e3543e.json +1 -0
  28. package/graphify-out/cache/644fcb129e595cfdb4e3a9757ed9658230347f5ed0652be45a894528a2b6585b.json +1 -0
  29. package/graphify-out/cache/6b8762db2c5f51408cf49d915f3e44bcc25c7ebb32abc635307fdf2a672b370c.json +1 -0
  30. package/graphify-out/cache/6db88050060880e56dd26ec58f29e3b56a409ace48e31bc75f54cab7dc74e409.json +1 -0
  31. package/graphify-out/cache/7932d1b6a9751b2cb2f4dc6b4e5f9fd7dcc2cee82d7866ec3d655482010533c0.json +1 -0
  32. package/graphify-out/cache/8140a76ff5b70dfdd0d020aeffff27f87af39da5b237c35baa938fcc4b288ba5.json +1 -0
  33. package/graphify-out/cache/8876638878758733a412bd4ca4cbd22863322689fbba9f037d92abfa877ea3ab.json +1 -0
  34. package/graphify-out/cache/90445359c448f8135207ddcd378c8391b9274460064cf998f1ea2ad6f2173703.json +1 -0
  35. package/graphify-out/cache/b01f675bb3942d2e8f359d11c38d52f28487544f54cdef518c60b7d8dfd2b383.json +1 -0
  36. package/graphify-out/cache/bc353b40b348d54c730d8498af675f57998b14ae796b4f952cdc200147008f13.json +1 -0
  37. package/graphify-out/cache/c38b2e784b1c441121b422db0c79b4911fb525d2a3cfad10d3fd561a07900bd5.json +1 -0
  38. package/graphify-out/cache/ce9df9bb2d36ecf310a53fb34526168bdf25773edf0826c1f55accebfa3c012d.json +1 -0
  39. package/graphify-out/cache/ceaeb0f99851d313b29cb1440240db1cf835de425b9b0c1e58fa3035355c2b2b.json +1 -0
  40. package/graphify-out/cache/d8f3e78931a41cd0f367fdab1d11b634bbffb2c90280c75a80a1a53a6b2d6bc7.json +1 -0
  41. package/graphify-out/cache/f574e4ce3bcb1250ca88410519fb4fd26c5b6cd786039410880fbd6e606ab23f.json +1 -0
  42. package/graphify-out/cache/faa65636d5f779b8b1c790dde11cc6470b48125bf42a12a77651827fd1653fd7.json +1 -0
  43. package/graphify-out/graph.json +4173 -2115
  44. package/ideal-plugins.csv +124 -0
  45. package/package.json +3 -2
  46. package/plugin-scores.csv +999 -0
  47. package/plugins/beads/plugin.json +2 -2
  48. package/plugins/biome/install-guidance.json +11 -0
  49. package/plugins/biome/meta.json +13 -0
  50. package/plugins/biome/plugin.json +83 -0
  51. package/plugins/biome/skills/quickstart/SKILL.md +25 -0
  52. package/plugins/bore/install-guidance.json +11 -0
  53. package/plugins/bore/meta.json +11 -0
  54. package/plugins/bore/plugin.json +65 -0
  55. package/plugins/bore/skills/quickstart/SKILL.md +25 -0
  56. package/plugins/ccf-deadlines/install-guidance.json +11 -0
  57. package/plugins/ccf-deadlines/meta.json +11 -0
  58. package/plugins/ccf-deadlines/plugin.json +28 -0
  59. package/plugins/ccf-deadlines/skills/quickstart/SKILL.md +25 -0
  60. package/plugins/code2prompt/install-guidance.json +11 -0
  61. package/plugins/code2prompt/meta.json +12 -0
  62. package/plugins/code2prompt/plugin.json +46 -0
  63. package/plugins/code2prompt/skills/quickstart/SKILL.md +25 -0
  64. package/plugins/commiat/install-guidance.json +10 -0
  65. package/plugins/commiat/plugin.json +2 -2
  66. package/plugins/dua-cli/install-guidance.json +11 -0
  67. package/plugins/dua-cli/meta.json +11 -0
  68. package/plugins/dua-cli/plugin.json +57 -0
  69. package/plugins/dua-cli/skills/quickstart/SKILL.md +25 -0
  70. package/plugins/forever/install-guidance.json +11 -0
  71. package/plugins/forever/meta.json +11 -0
  72. package/plugins/forever/plugin.json +75 -0
  73. package/plugins/forever/skills/quickstart/SKILL.md +25 -0
  74. package/plugins/gitmoji-cli/install-guidance.json +11 -0
  75. package/plugins/gitmoji-cli/meta.json +11 -0
  76. package/plugins/gitmoji-cli/plugin.json +49 -0
  77. package/plugins/gitmoji-cli/skills/quickstart/SKILL.md +25 -0
  78. package/plugins/google-maps-scraper/plugin.json +1 -1
  79. package/plugins/gwc/install-guidance.json +10 -0
  80. package/plugins/gwc/plugin.json +2 -2
  81. package/plugins/quarto/install-guidance.json +11 -0
  82. package/plugins/quarto/meta.json +11 -0
  83. package/plugins/quarto/plugin.json +61 -0
  84. package/plugins/quarto/skills/quickstart/SKILL.md +25 -0
  85. package/plugins/readme-md-generator/install-guidance.json +11 -0
  86. package/plugins/readme-md-generator/meta.json +11 -0
  87. package/plugins/readme-md-generator/plugin.json +28 -0
  88. package/plugins/readme-md-generator/skills/quickstart/SKILL.md +25 -0
  89. package/plugins/twarc/install-guidance.json +11 -0
  90. package/plugins/twarc/meta.json +13 -0
  91. package/plugins/twarc/plugin.json +165 -0
  92. package/plugins/twarc/skills/quickstart/SKILL.md +61 -0
  93. package/plugins/vale/install-guidance.json +11 -0
  94. package/plugins/vale/meta.json +12 -0
  95. package/plugins/vale/plugin.json +50 -0
  96. package/plugins/vale/skills/quickstart/SKILL.md +25 -0
  97. package/plugins/volta/install-guidance.json +11 -0
  98. package/plugins/volta/meta.json +12 -0
  99. package/plugins/volta/plugin.json +75 -0
  100. package/plugins/volta/skills/quickstart/SKILL.md +25 -0
  101. package/plugins/wgcf/install-guidance.json +11 -0
  102. package/plugins/wgcf/meta.json +12 -0
  103. package/plugins/wgcf/plugin.json +45 -0
  104. package/plugins/wgcf/skills/quickstart/SKILL.md +25 -0
  105. package/scripts/analyze-plugins.js +130 -0
  106. package/scripts/enrich-meta-plugins.js +67 -0
  107. package/server/app.js +23 -1
  108. package/server/routes/adapters.js +356 -0
  109. package/server/routes/dashboard.js +113 -0
  110. package/server/routes/jobs.js +26 -0
  111. package/server/services/adaptersService.js +284 -0
  112. package/server/services/pluginsService.js +4 -0
  113. package/server/views/adapter-edit.ejs +226 -0
  114. package/server/views/adapter-packages.ejs +191 -0
  115. package/server/views/adapters.ejs +112 -0
  116. package/server/views/command-edit.ejs +48 -21
  117. package/server/views/commands.ejs +25 -22
  118. package/server/views/dashboard.ejs +196 -0
  119. package/server/views/layout.ejs +94 -14
  120. package/server/views/mcp.ejs +38 -35
  121. package/server/views/partials/head.ejs +88 -12
  122. package/server/views/plugins.ejs +9 -0
  123. package/server/views/specs.ejs +33 -30
  124. package/cli/adapters/builtin.js +0 -43
  125. package/index.html +0 -384
@@ -0,0 +1,25 @@
1
+ # forever Quickstart
2
+
3
+ Ensure scripts run continuously
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install -g forever
9
+ ```
10
+
11
+ ## Quick Examples
12
+
13
+ ```bash
14
+ # Check version
15
+ forever --version
16
+
17
+ # Get help
18
+ forever --help
19
+ ```
20
+
21
+ ## Resources
22
+
23
+ - GitHub: https://github.com/foreversd/forever
24
+ - Stars: 13,847
25
+ - Language: nodejs
@@ -0,0 +1,11 @@
1
+ {
2
+ "plugin": "gitmoji-cli",
3
+ "binary": "gitmoji",
4
+ "check": "which gitmoji",
5
+ "install_steps": [
6
+ "npm install -g gitmoji-cli",
7
+ "Verify: gitmoji --version",
8
+ "supercli plugins install ./plugins/gitmoji-cli --on-conflict replace --json"
9
+ ],
10
+ "note": "Source: https://github.com/carloscuesta/gitmoji-cli (4,826 stars). Written in nodejs."
11
+ }
@@ -0,0 +1,11 @@
1
+ {
2
+ "description": "Interactive CLI for using emojis on commits",
3
+ "tags": [
4
+ "gitmoji",
5
+ "git",
6
+ "commits",
7
+ "emoji",
8
+ "nodejs"
9
+ ],
10
+ "has_learn": true
11
+ }
@@ -0,0 +1,49 @@
1
+ {
2
+ "name": "gitmoji-cli",
3
+ "version": "0.1.0",
4
+ "description": "Interactive CLI for using emojis on commits",
5
+ "source": "https://github.com/carloscuesta/gitmoji-cli",
6
+ "checks": [
7
+ {
8
+ "type": "binary",
9
+ "name": "gitmoji"
10
+ }
11
+ ],
12
+ "learn": {
13
+ "file": "skills/quickstart/SKILL.md"
14
+ },
15
+ "commands": [
16
+ {
17
+ "namespace": "gitmoji",
18
+ "resource": "commit",
19
+ "action": "interactive",
20
+ "description": "Interactive commit with emoji",
21
+ "adapter": "process",
22
+ "adapterConfig": {
23
+ "command": "gitmoji",
24
+ "passthrough": true
25
+ },
26
+ "args": [
27
+ {
28
+ "name": "--commit",
29
+ "type": "boolean",
30
+ "description": "Commit changes"
31
+ }
32
+ ]
33
+ },
34
+ {
35
+ "namespace": "gitmoji",
36
+ "resource": "list",
37
+ "action": "show",
38
+ "description": "List all gitmojis",
39
+ "adapter": "process",
40
+ "adapterConfig": {
41
+ "command": "gitmoji",
42
+ "baseArgs": [
43
+ "-l"
44
+ ],
45
+ "passthrough": true
46
+ }
47
+ }
48
+ ]
49
+ }
@@ -0,0 +1,25 @@
1
+ # gitmoji Quickstart
2
+
3
+ Interactive CLI for using emojis on commits
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install -g gitmoji-cli
9
+ ```
10
+
11
+ ## Quick Examples
12
+
13
+ ```bash
14
+ # Check version
15
+ gitmoji --version
16
+
17
+ # Get help
18
+ gitmoji --help
19
+ ```
20
+
21
+ ## Resources
22
+
23
+ - GitHub: https://github.com/carloscuesta/gitmoji-cli
24
+ - Stars: 4,826
25
+ - Language: nodejs
@@ -24,7 +24,7 @@
24
24
  "resource": "search",
25
25
  "action": "scrape",
26
26
  "description": "Scrape Google Maps for business data",
27
- "adapter": "builtin",
27
+ "adapter": "custom",
28
28
  "adapterConfig": {
29
29
  "handler": "google-maps-scraper-scrape"
30
30
  },
@@ -0,0 +1,10 @@
1
+ {
2
+ "plugin": "gwc",
3
+ "binary": "gws",
4
+ "check": "gws --version",
5
+ "install_steps": [
6
+ "npm install -g @googleworkspace/cli",
7
+ "gws --version"
8
+ ],
9
+ "note": "Installation is intentionally delegated to your LLM/automation flow (dcli/scli/supercli)."
10
+ }
@@ -12,8 +12,8 @@
12
12
  "resource": "install",
13
13
  "action": "steps",
14
14
  "description": "Show gws installation steps for LLM automation",
15
- "adapter": "builtin",
16
- "adapterConfig": { "builtin": "gwc_install_steps" },
15
+ "adapter": "shell",
16
+ "adapterConfig": { "script": "cat install-guidance.json", "unsafe": true },
17
17
  "args": []
18
18
  },
19
19
  {
@@ -0,0 +1,11 @@
1
+ {
2
+ "plugin": "quarto",
3
+ "binary": "quarto",
4
+ "check": "which quarto",
5
+ "install_steps": [
6
+ "brew install quarto",
7
+ "Verify: quarto --version",
8
+ "supercli plugins install ./plugins/quarto --on-conflict replace --json"
9
+ ],
10
+ "note": "Source: https://github.com/quarto-dev/quarto-cli (5,567 stars). Written in nodejs."
11
+ }
@@ -0,0 +1,11 @@
1
+ {
2
+ "description": "Open-source scientific and technical publishing system",
3
+ "tags": [
4
+ "quarto",
5
+ "publishing",
6
+ "documents",
7
+ "markdown",
8
+ "scientific"
9
+ ],
10
+ "has_learn": true
11
+ }
@@ -0,0 +1,61 @@
1
+ {
2
+ "name": "quarto",
3
+ "version": "0.1.0",
4
+ "description": "Open-source scientific and technical publishing system",
5
+ "source": "https://github.com/quarto-dev/quarto-cli",
6
+ "checks": [
7
+ {
8
+ "type": "binary",
9
+ "name": "quarto"
10
+ }
11
+ ],
12
+ "learn": {
13
+ "file": "skills/quickstart/SKILL.md"
14
+ },
15
+ "commands": [
16
+ {
17
+ "namespace": "quarto",
18
+ "resource": "document",
19
+ "action": "render",
20
+ "description": "Render document",
21
+ "adapter": "process",
22
+ "adapterConfig": {
23
+ "command": "quarto",
24
+ "baseArgs": [
25
+ "render"
26
+ ],
27
+ "passthrough": true
28
+ },
29
+ "args": [
30
+ {
31
+ "name": "file",
32
+ "type": "string",
33
+ "required": true,
34
+ "description": "File to render"
35
+ }
36
+ ]
37
+ },
38
+ {
39
+ "namespace": "quarto",
40
+ "resource": "preview",
41
+ "action": "document",
42
+ "description": "Preview document",
43
+ "adapter": "process",
44
+ "adapterConfig": {
45
+ "command": "quarto",
46
+ "baseArgs": [
47
+ "preview"
48
+ ],
49
+ "passthrough": true
50
+ },
51
+ "args": [
52
+ {
53
+ "name": "file",
54
+ "type": "string",
55
+ "required": true,
56
+ "description": "File to preview"
57
+ }
58
+ ]
59
+ }
60
+ ]
61
+ }
@@ -0,0 +1,25 @@
1
+ # quarto Quickstart
2
+
3
+ Open-source scientific and technical publishing system
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ brew install quarto
9
+ ```
10
+
11
+ ## Quick Examples
12
+
13
+ ```bash
14
+ # Check version
15
+ quarto --version
16
+
17
+ # Get help
18
+ quarto --help
19
+ ```
20
+
21
+ ## Resources
22
+
23
+ - GitHub: https://github.com/quarto-dev/quarto-cli
24
+ - Stars: 5,567
25
+ - Language: nodejs
@@ -0,0 +1,11 @@
1
+ {
2
+ "plugin": "readme-md-generator",
3
+ "binary": "readme-md-generator",
4
+ "check": "which readme-md-generator",
5
+ "install_steps": [
6
+ "npm install -g readme-md-generator",
7
+ "Verify: readme-md-generator --version",
8
+ "supercli plugins install ./plugins/readme-md-generator --on-conflict replace --json"
9
+ ],
10
+ "note": "Source: https://github.com/kefranabg/readme-md-generator (11,108 stars). Written in nodejs."
11
+ }
@@ -0,0 +1,11 @@
1
+ {
2
+ "description": "Generate beautiful README.md files interactively",
3
+ "tags": [
4
+ "readme",
5
+ "generator",
6
+ "documentation",
7
+ "markdown",
8
+ "nodejs"
9
+ ],
10
+ "has_learn": true
11
+ }
@@ -0,0 +1,28 @@
1
+ {
2
+ "name": "readme-md-generator",
3
+ "version": "0.1.0",
4
+ "description": "Generate beautiful README.md files interactively",
5
+ "source": "https://github.com/kefranabg/readme-md-generator",
6
+ "checks": [
7
+ {
8
+ "type": "binary",
9
+ "name": "readme-md-generator"
10
+ }
11
+ ],
12
+ "learn": {
13
+ "file": "skills/quickstart/SKILL.md"
14
+ },
15
+ "commands": [
16
+ {
17
+ "namespace": "readme",
18
+ "resource": "generate",
19
+ "action": "interactive",
20
+ "description": "Generate README interactively",
21
+ "adapter": "process",
22
+ "adapterConfig": {
23
+ "command": "readme-md-generator",
24
+ "passthrough": true
25
+ }
26
+ }
27
+ ]
28
+ }
@@ -0,0 +1,25 @@
1
+ # readme-gen Quickstart
2
+
3
+ Generate beautiful README.md files interactively
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install -g readme-md-generator
9
+ ```
10
+
11
+ ## Quick Examples
12
+
13
+ ```bash
14
+ # Check version
15
+ readme-gen --version
16
+
17
+ # Get help
18
+ readme-gen --help
19
+ ```
20
+
21
+ ## Resources
22
+
23
+ - GitHub: https://github.com/kefranabg/readme-md-generator
24
+ - Stars: 11,108
25
+ - Language: nodejs
@@ -0,0 +1,11 @@
1
+ {
2
+ "plugin": "twarc",
3
+ "binary": "twarc",
4
+ "check": "which twarc",
5
+ "install_steps": [
6
+ "pip install twarc",
7
+ "Verify: twarc --version",
8
+ "supercli plugins install ./plugins/twarc --on-conflict replace --json"
9
+ ],
10
+ "note": "Requires X API credentials (API key, secret, access token, secret) to configure with 'twarc configure'"
11
+ }
@@ -0,0 +1,13 @@
1
+ {
2
+ "description": "CLI tool for archiving Twitter/X data - export tweets to CSV/JSON",
3
+ "tags": [
4
+ "twarc",
5
+ "twitter",
6
+ "x",
7
+ "archive",
8
+ "export",
9
+ "csv",
10
+ "json"
11
+ ],
12
+ "has_learn": true
13
+ }
@@ -0,0 +1,165 @@
1
+ {
2
+ "name": "twarc",
3
+ "version": "0.1.0",
4
+ "description": "CLI tool for archiving Twitter/X data",
5
+ "source": "https://github.com/DocNow/twarc",
6
+ "checks": [
7
+ {
8
+ "type": "binary",
9
+ "name": "twarc"
10
+ }
11
+ ],
12
+ "install_guidance": {
13
+ "plugin": "twarc",
14
+ "binary": "twarc",
15
+ "check": "which twarc",
16
+ "install_steps": [
17
+ "pip install twarc",
18
+ "Verify: twarc --version",
19
+ "supercli plugins install ./plugins/twarc --on-conflict replace --json"
20
+ ]
21
+ },
22
+ "learn": {
23
+ "file": "skills/quickstart/SKILL.md"
24
+ },
25
+ "commands": [
26
+ {
27
+ "namespace": "twarc",
28
+ "resource": "self",
29
+ "action": "version",
30
+ "description": "Print twarc version",
31
+ "adapter": "process",
32
+ "adapterConfig": {
33
+ "command": "twarc",
34
+ "missingDependencyHelp": "Install twarc: pip install twarc",
35
+ "baseArgs": [
36
+ "--version"
37
+ ]
38
+ },
39
+ "args": []
40
+ },
41
+ {
42
+ "namespace": "twarc",
43
+ "resource": "configure",
44
+ "action": "run",
45
+ "description": "Configure twarc with X API credentials",
46
+ "adapter": "process",
47
+ "adapterConfig": {
48
+ "command": "twarc",
49
+ "missingDependencyHelp": "Install twarc: pip install twarc",
50
+ "baseArgs": [
51
+ "configure"
52
+ ],
53
+ "passthrough": true,
54
+ "timeout_ms": 60000
55
+ },
56
+ "args": [
57
+ {
58
+ "name": "args",
59
+ "type": "string",
60
+ "required": false,
61
+ "description": "Additional arguments"
62
+ }
63
+ ]
64
+ },
65
+ {
66
+ "namespace": "twarc",
67
+ "resource": "timeline",
68
+ "action": "export",
69
+ "description": "Export user timeline to JSON",
70
+ "adapter": "process",
71
+ "adapterConfig": {
72
+ "command": "twarc",
73
+ "missingDependencyHelp": "Install twarc: pip install twarc",
74
+ "baseArgs": [
75
+ "timeline"
76
+ ],
77
+ "passthrough": true,
78
+ "timeout_ms": 300000
79
+ },
80
+ "args": [
81
+ {
82
+ "name": "username",
83
+ "type": "string",
84
+ "required": true,
85
+ "description": "Twitter/X username (without @)"
86
+ },
87
+ {
88
+ "name": "output_file",
89
+ "type": "string",
90
+ "required": false,
91
+ "description": "Output file path"
92
+ }
93
+ ]
94
+ },
95
+ {
96
+ "namespace": "twarc",
97
+ "resource": "timeline",
98
+ "action": "export_csv",
99
+ "description": "Export user timeline to CSV",
100
+ "adapter": "process",
101
+ "adapterConfig": {
102
+ "command": "twarc",
103
+ "missingDependencyHelp": "Install twarc: pip install twarc",
104
+ "baseArgs": [
105
+ "timeline",
106
+ "--format",
107
+ "csv"
108
+ ],
109
+ "passthrough": true,
110
+ "timeout_ms": 300000
111
+ },
112
+ "args": [
113
+ {
114
+ "name": "username",
115
+ "type": "string",
116
+ "required": true,
117
+ "description": "Twitter/X username (without @)"
118
+ },
119
+ {
120
+ "name": "output_file",
121
+ "type": "string",
122
+ "required": false,
123
+ "description": "Output file path"
124
+ }
125
+ ]
126
+ },
127
+ {
128
+ "namespace": "twarc",
129
+ "resource": "help",
130
+ "action": "show",
131
+ "description": "Show twarc help",
132
+ "adapter": "process",
133
+ "adapterConfig": {
134
+ "command": "twarc",
135
+ "missingDependencyHelp": "Install twarc: pip install twarc",
136
+ "baseArgs": [
137
+ "--help"
138
+ ],
139
+ "passthrough": true,
140
+ "timeout_ms": 30000
141
+ },
142
+ "args": []
143
+ },
144
+ {
145
+ "namespace": "twarc",
146
+ "resource": "_",
147
+ "action": "_",
148
+ "description": "Run any twarc command",
149
+ "adapter": "process",
150
+ "adapterConfig": {
151
+ "command": "twarc",
152
+ "missingDependencyHelp": "Install twarc: pip install twarc",
153
+ "passthrough": true
154
+ },
155
+ "args": [
156
+ {
157
+ "name": "args",
158
+ "type": "string",
159
+ "required": false,
160
+ "description": "Additional arguments"
161
+ }
162
+ ]
163
+ }
164
+ ]
165
+ }
@@ -0,0 +1,61 @@
1
+ ---
2
+ name: twarc
3
+ description: Use this skill when the user wants to archive Twitter/X data, export tweets to CSV/JSON, or work with twarc CLI tool.
4
+ ---
5
+
6
+ # twarc Plugin
7
+
8
+ CLI tool for archiving Twitter/X data. Export your tweets to CSV or JSON format.
9
+
10
+ ## Commands
11
+
12
+ ### Configuration
13
+ - `twarc configure run` — Configure twarc with X API credentials
14
+
15
+ ### Export Operations
16
+ - `twarc timeline export <username>` — Export user timeline to JSON
17
+ - `twarc timeline export_csv <username>` — Export user timeline to CSV
18
+
19
+ ### Utility
20
+ - `twarc self version` — Print twarc version
21
+ - `twarc help show` — Show twarc help
22
+ - `twarc _ _` — Run any twarc command directly
23
+
24
+ ## Usage Examples
25
+
26
+ ### Export all your tweets to JSON
27
+ ```bash
28
+ twarc configure run # First time setup with API credentials
29
+ twarc timeline export your_username > tweets.json
30
+ ```
31
+
32
+ ### Export all your tweets to CSV
33
+ ```bash
34
+ twarc timeline export_csv your_username > tweets.csv
35
+ ```
36
+
37
+ ## Installation
38
+
39
+ ```bash
40
+ pip install twarc
41
+ ```
42
+
43
+ ## Configuration
44
+
45
+ Before using twarc, you need to configure it with X API credentials:
46
+
47
+ 1. Go to https://developer.twitter.com/en/portal/dashboard
48
+ 2. Create a new app and get API credentials
49
+ 3. Run `twarc configure` and enter your credentials when prompted
50
+
51
+ Required credentials:
52
+ - Consumer Key (API Key)
53
+ - Consumer Secret (API Secret)
54
+ - Access Token
55
+ - Access Token Secret
56
+
57
+ ## Key Features
58
+ - Archive all tweets from a user timeline
59
+ - Export to JSON or CSV format
60
+ - Full tweet data including metadata
61
+ - Supports filtering and search
@@ -0,0 +1,11 @@
1
+ {
2
+ "plugin": "vale",
3
+ "binary": "vale",
4
+ "check": "which vale",
5
+ "install_steps": [
6
+ "brew install vale",
7
+ "Verify: vale --version",
8
+ "supercli plugins install ./plugins/vale --on-conflict replace --json"
9
+ ],
10
+ "note": "Source: https://github.com/vale-cli/vale (5,360 stars). Written in go."
11
+ }
@@ -0,0 +1,12 @@
1
+ {
2
+ "description": "Markup-aware linter for prose",
3
+ "tags": [
4
+ "vale",
5
+ "linter",
6
+ "prose",
7
+ "writing",
8
+ "documentation",
9
+ "go"
10
+ ],
11
+ "has_learn": true
12
+ }
@@ -0,0 +1,50 @@
1
+ {
2
+ "name": "vale",
3
+ "version": "0.1.0",
4
+ "description": "Markup-aware linter for prose",
5
+ "source": "https://github.com/vale-cli/vale",
6
+ "checks": [
7
+ {
8
+ "type": "binary",
9
+ "name": "vale"
10
+ }
11
+ ],
12
+ "learn": {
13
+ "file": "skills/quickstart/SKILL.md"
14
+ },
15
+ "commands": [
16
+ {
17
+ "namespace": "vale",
18
+ "resource": "lint",
19
+ "action": "run",
20
+ "description": "Lint prose files",
21
+ "adapter": "process",
22
+ "adapterConfig": {
23
+ "command": "vale",
24
+ "passthrough": true
25
+ },
26
+ "args": [
27
+ {
28
+ "name": "files",
29
+ "type": "string",
30
+ "required": true,
31
+ "description": "Files to lint"
32
+ }
33
+ ]
34
+ },
35
+ {
36
+ "namespace": "vale",
37
+ "resource": "config",
38
+ "action": "init",
39
+ "description": "Initialize vale config",
40
+ "adapter": "process",
41
+ "adapterConfig": {
42
+ "command": "vale",
43
+ "baseArgs": [
44
+ "--config"
45
+ ],
46
+ "passthrough": true
47
+ }
48
+ }
49
+ ]
50
+ }