@m2015agg/supabase-skill 0.2.4 → 0.3.1
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/dist/commands/docs.js +61 -48
- package/dist/commands/docs.js.map +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
package/dist/commands/docs.js
CHANGED
|
@@ -46,66 +46,79 @@ All commands support \`-o json\` for structured output.
|
|
|
46
46
|
|
|
47
47
|
${envSection}
|
|
48
48
|
|
|
49
|
-
###
|
|
50
|
-
|
|
51
|
-
-
|
|
52
|
-
- \`
|
|
53
|
-
-
|
|
49
|
+
### IMPORTANT: CLI Flag Reference
|
|
50
|
+
- Database commands (db, migration, inspect, storage) use \`--linked\` (requires \`supabase link\` first)
|
|
51
|
+
- Management commands (functions, projects, secrets, snippets) use \`--project-ref <ref>\`
|
|
52
|
+
- \`supabase db execute\` does NOT exist — use REST API or psql instead
|
|
53
|
+
- To switch linked project: \`supabase link --project-ref <ref>\`
|
|
54
|
+
|
|
55
|
+
### Project Linking (required before db/migration/inspect/storage commands)
|
|
56
|
+
- \`supabase link --project-ref <ref>\` — link current directory to a Supabase project
|
|
57
|
+
- Must run from a directory with \`supabase/config.toml\` (or run \`supabase init\` first)
|
|
58
|
+
- Only one project can be linked at a time per directory
|
|
59
|
+
|
|
60
|
+
### SQL Execution (via REST API or psql)
|
|
61
|
+
\`supabase db execute\` does NOT exist. Use these methods:
|
|
62
|
+
- **Query table (GET)**: \`curl -s "$SUPABASE_<ENV>_URL/rest/v1/<table>?select=*&limit=10" -H "apikey: $SUPABASE_<ENV>_SERVICE_KEY" -H "Authorization: Bearer $SUPABASE_<ENV>_SERVICE_KEY" -H "Accept-Profile: bibleai"\`
|
|
63
|
+
- **Call RPC (POST)**: \`curl -s "$SUPABASE_<ENV>_URL/rest/v1/rpc/<function>" -X POST -H "apikey: $SUPABASE_<ENV>_SERVICE_KEY" -H "Authorization: Bearer $SUPABASE_<ENV>_SERVICE_KEY" -H "Content-Profile: bibleai" -H "Content-Type: application/json" -d '{}'\`
|
|
64
|
+
- **Direct SQL**: \`psql "$DATABASE_URL" -c "SELECT 1"\` (if connection string available)
|
|
65
|
+
- **Header rules**: GET uses \`Accept-Profile: bibleai\`, POST uses \`Content-Profile: bibleai\`
|
|
54
66
|
- Load env vars first: \`source .env\` or \`export $(grep -v '^#' .env | xargs)\`
|
|
55
67
|
|
|
56
|
-
### Migrations
|
|
57
|
-
- \`supabase migration new <name>\` — create empty migration file
|
|
58
|
-
- \`supabase migration list
|
|
59
|
-
- \`supabase migration up
|
|
60
|
-
- \`supabase migration down
|
|
61
|
-
- \`supabase migration repair --status applied <version
|
|
62
|
-
- \`supabase migration repair --status reverted <version
|
|
63
|
-
- \`supabase migration squash
|
|
64
|
-
- \`supabase migration fetch
|
|
65
|
-
|
|
66
|
-
### Schema Management
|
|
67
|
-
- \`supabase db diff
|
|
68
|
-
- \`supabase db dump
|
|
69
|
-
- \`supabase db dump --
|
|
70
|
-
- \`supabase db dump
|
|
71
|
-
- \`supabase db pull
|
|
72
|
-
- \`supabase db push
|
|
73
|
-
- \`supabase db lint\` — check for typing errors
|
|
74
|
-
|
|
75
|
-
### Database Inspection (
|
|
76
|
-
- \`supabase inspect db table-stats
|
|
77
|
-
- \`supabase inspect db index-stats
|
|
78
|
-
- \`supabase inspect db long-running-queries
|
|
79
|
-
- \`supabase inspect db outliers
|
|
80
|
-
- \`supabase inspect db bloat
|
|
81
|
-
- \`supabase inspect db locks
|
|
82
|
-
- \`supabase inspect db blocking
|
|
83
|
-
- \`supabase inspect db db-stats
|
|
84
|
-
- \`supabase inspect db vacuum-stats
|
|
85
|
-
- \`supabase inspect db role-stats
|
|
86
|
-
- \`supabase inspect db replication-slots
|
|
87
|
-
- \`supabase inspect report
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
- \`supabase storage
|
|
92
|
-
- \`supabase storage cp ss
|
|
93
|
-
- \`supabase storage
|
|
94
|
-
- \`supabase storage
|
|
95
|
-
|
|
96
|
-
|
|
68
|
+
### Migrations (uses --linked, NOT --project-ref)
|
|
69
|
+
- \`supabase migration new <name>\` — create empty migration file (local only)
|
|
70
|
+
- \`supabase migration list\` — compare local vs remote (linked project)
|
|
71
|
+
- \`supabase migration up\` — apply pending migrations to linked project
|
|
72
|
+
- \`supabase migration down -n 1\` — rollback last N migrations
|
|
73
|
+
- \`supabase migration repair --status applied <version>\` — mark version as applied
|
|
74
|
+
- \`supabase migration repair --status reverted <version>\` — mark version as reverted
|
|
75
|
+
- \`supabase migration squash\` — combine into single file
|
|
76
|
+
- \`supabase migration fetch\` — pull migration history from remote
|
|
77
|
+
|
|
78
|
+
### Schema Management (uses --linked, NOT --project-ref)
|
|
79
|
+
- \`supabase db diff\` — diff local vs remote schema
|
|
80
|
+
- \`supabase db dump\` — dump full schema from linked project
|
|
81
|
+
- \`supabase db dump --data-only\` — dump data only
|
|
82
|
+
- \`supabase db dump -s bibleai\` — dump specific schema
|
|
83
|
+
- \`supabase db pull\` — pull remote schema to local migrations
|
|
84
|
+
- \`supabase db push\` — push migrations to remote
|
|
85
|
+
- \`supabase db lint\` — check for typing errors (local only)
|
|
86
|
+
|
|
87
|
+
### Database Inspection (uses --linked or --db-url, NOT --project-ref)
|
|
88
|
+
- \`supabase inspect db table-stats\` — table sizes + row counts
|
|
89
|
+
- \`supabase inspect db index-stats\` — index usage + scan counts
|
|
90
|
+
- \`supabase inspect db long-running-queries\` — queries > 5min
|
|
91
|
+
- \`supabase inspect db outliers\` — slowest queries by total time
|
|
92
|
+
- \`supabase inspect db bloat\` — dead tuple estimation
|
|
93
|
+
- \`supabase inspect db locks\` — active locks
|
|
94
|
+
- \`supabase inspect db blocking\` — blocking lock chains
|
|
95
|
+
- \`supabase inspect db db-stats\` — cache hit rates, WAL, sizes
|
|
96
|
+
- \`supabase inspect db vacuum-stats\` — vacuum status per table
|
|
97
|
+
- \`supabase inspect db role-stats\` — role information
|
|
98
|
+
- \`supabase inspect db replication-slots\` — replication status
|
|
99
|
+
- \`supabase inspect report\` — CSV of ALL inspect commands
|
|
100
|
+
- Alternative: \`supabase inspect db table-stats --db-url "postgresql://..."\` — inspect without linking
|
|
101
|
+
|
|
102
|
+
### Storage (uses --linked + --experimental)
|
|
103
|
+
- \`supabase storage ls ss:///bucket/path --experimental\` — list objects (note: triple slash ss:///)
|
|
104
|
+
- \`supabase storage cp local.file ss:///bucket/path --experimental\` — upload
|
|
105
|
+
- \`supabase storage cp ss:///bucket/path local.file --experimental\` — download
|
|
106
|
+
- \`supabase storage rm ss:///bucket/path --experimental\` — delete
|
|
107
|
+
- \`supabase storage mv ss:///old ss:///new --experimental\` — move/rename
|
|
108
|
+
|
|
109
|
+
### Edge Functions (uses --project-ref)
|
|
97
110
|
- \`supabase functions list --project-ref <ref>\` — list deployed functions
|
|
98
111
|
- \`supabase functions deploy <name> --project-ref <ref>\` — deploy function
|
|
99
112
|
- \`supabase functions delete <name> --project-ref <ref>\` — delete function
|
|
100
113
|
- \`supabase functions serve\` — serve locally for testing
|
|
101
114
|
|
|
102
|
-
### Project Management
|
|
115
|
+
### Project Management (uses --project-ref)
|
|
103
116
|
- \`supabase projects list -o json\` — list all projects
|
|
104
117
|
- \`supabase projects api-keys --project-ref <ref> -o json\` — get API keys
|
|
105
118
|
- \`supabase secrets list --project-ref <ref>\` — list env secrets
|
|
106
119
|
- \`supabase secrets set KEY=VALUE --project-ref <ref>\` — set secret
|
|
107
120
|
|
|
108
|
-
### SQL Snippets (
|
|
121
|
+
### SQL Snippets (uses --project-ref)
|
|
109
122
|
- \`supabase snippets list --project-ref <ref> -o json\` — list saved snippets
|
|
110
123
|
- \`supabase snippets download <id> --project-ref <ref>\` — download snippet SQL
|
|
111
124
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAC;AAEjE,SAAS,eAAe,CAAC,MAA0B;IACjD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO;;wDAE6C,CAAC;IACvD,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACnC,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACvE,MAAM,OAAO,GAAG,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,wDAAwD,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,GAAG,OAAO,IAAI,IAAI,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,oBAAoB;IACpB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;IAC1E,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACjE,MAAM,OAAO,GAAG,GAAG,KAAK,MAAM;YAC5B,CAAC,CAAC,8BAA8B;YAChC,CAAC,CAAC,GAAG,KAAK,OAAO;gBACf,CAAC,CAAC,uCAAuC;gBACzC,CAAC,CAAC,+BAA+B,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,sBAAsB,GAAG,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,6FAA6F,CAAC,CAAC;IAC5G,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IAC7E,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,YAAY,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,WAAW,EAAE,QAAQ,MAAM,cAAc,MAAM,sBAAsB,MAAM,aAAa,CAAC,CAAC;IAChH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;IAElF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAA6B,IAAI;IAC3D,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAE3C,OAAO;;;;;EAKP,UAAU
|
|
1
|
+
{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -15,7 +15,7 @@ const program = new Command();
|
|
|
15
15
|
program
|
|
16
16
|
.name("supabase-skill")
|
|
17
17
|
.description("Supabase CLI skill for AI agents. Installs comprehensive CLI instructions into CLAUDE.md with multi-environment support.")
|
|
18
|
-
.version("0.
|
|
18
|
+
.version("0.3.1");
|
|
19
19
|
program.addCommand(installCommand());
|
|
20
20
|
program.addCommand(initCommand());
|
|
21
21
|
program.addCommand(docsCommand());
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@m2015agg/supabase-skill",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.3.1",
|
|
4
4
|
"description": "Supabase CLI skill for AI agents. Installs comprehensive CLI instructions into CLAUDE.md, AGENTS.md, or .cursorrules with multi-environment support.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|