Motel Debug
kitlangton/motel
Debug applications with motel, a local OpenTelemetry ingest and query server.
Use file-based span/log export for AI consumption. An agent skill from forcedotcom/salesforcedx-vscode.
$ npx skills add forcedotcom/salesforcedx-vscode --skill span-file-export -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install forcedotcom/salesforcedx-vscode span-file-export --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/forcedotcom/salesforcedx-vscode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/span-file-export .claude/skills/span-file-export && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "span-file-export" agent skill from https://github.com/forcedotcom/salesforcedx-vscode/tree/develop/.claude/skills/span-file-export into .claude/skills/span-file-export/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "span-file-export", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/forcedotcom/salesforcedx-vscode/tree/develop/.claude/skills/span-file-exportType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add forcedotcom/salesforcedx-vscode --skill span-file-export -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install forcedotcom/salesforcedx-vscode span-file-export --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/forcedotcom/salesforcedx-vscode.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/span-file-export .agents/skills/span-file-export && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "span-file-export" agent skill from https://github.com/forcedotcom/salesforcedx-vscode/tree/develop/.claude/skills/span-file-export into .agents/skills/span-file-export/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "span-file-export", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add forcedotcom/salesforcedx-vscode --skill span-file-export -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install forcedotcom/salesforcedx-vscode span-file-export --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/forcedotcom/salesforcedx-vscode.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/span-file-export .cursor/skills/span-file-export && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "span-file-export" agent skill from https://github.com/forcedotcom/salesforcedx-vscode/tree/develop/.claude/skills/span-file-export into .cursor/skills/span-file-export/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "span-file-export", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/forcedotcom/salesforcedx-vscode.git --path .claude/skills/span-file-export--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add forcedotcom/salesforcedx-vscode --skill span-file-export -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install forcedotcom/salesforcedx-vscode span-file-export --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/forcedotcom/salesforcedx-vscode.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/span-file-export .gemini/skills/span-file-export && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "span-file-export" agent skill from https://github.com/forcedotcom/salesforcedx-vscode/tree/develop/.claude/skills/span-file-export into .gemini/skills/span-file-export/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "span-file-export", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install forcedotcom/salesforcedx-vscode span-file-exportInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add forcedotcom/salesforcedx-vscode --skill span-file-export -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/forcedotcom/salesforcedx-vscode.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/span-file-export .github/skills/span-file-export && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "span-file-export" agent skill from https://github.com/forcedotcom/salesforcedx-vscode/tree/develop/.claude/skills/span-file-export into .github/skills/span-file-export/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "span-file-export", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add forcedotcom/salesforcedx-vscode --skill span-file-export -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install forcedotcom/salesforcedx-vscode span-file-export --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/forcedotcom/salesforcedx-vscode.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/span-file-export .opencode/skills/span-file-export && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "span-file-export" agent skill from https://github.com/forcedotcom/salesforcedx-vscode/tree/develop/.claude/skills/span-file-export into .opencode/skills/span-file-export/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "span-file-export", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
span-file-exportUse file-based span/log export for AI consumption. An agent skill from forcedotcom/salesforcedx-vscode.
Span File Export is an agent skill from forcedotcom/salesforcedx-vscode. Use file-based span/log export for AI consumption. Where it lives, how to enable/clear, record format for Node and Web. Use when enabling span file dump, debugging traces for AI, or configuring local observability.
Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud, covering Observability. It works with Visual Studio Code and OpenTelemetry. The repository describes itself as: Salesforce Extensions for VS Code. The licence is BSD-3-Clause.
3 steps, taken from the first numbered list in SKILL.md.
Read from SKILL.md and the folder at commit 27807f6. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
npmjqFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Span File Export loads about 2.2k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 632 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from forcedotcom/salesforcedx-vscode at commit 27807f6, republished under its BSD-3-Clause licence (© forcedotcom). 632 words, ~2,203 tokens.
.claude/skills/span-file-export/SKILL.md (or your agent's skills folder).Local OTLP export to ~/.sf/vscode-spans/ for AI consumers. Spans + log records interleaved in one JSONL file.
| Setting | Default | Purpose |
|---|---|---|
salesforcedx-vscode-salesforcedx.enableFileTraces | false | Enable file capture (spans + logs) |
salesforcedx-vscode-salesforcedx.logLevel | error | Min log level exported. info/debug for most logs. |
SF_LOG_LEVEL env var | — | Fallback when setting unset (fatal→error) |
Reload window after changing — SDK layer builds at activation.
Dir: ~/.sf/vscode-spans/. Filename: {ISO-timestamp}.jsonl (e.g. 2026-05-22T15-33-01-398Z.jsonl).
Latest: ls -lt ~/.sf/vscode-spans/ | head -1
Each line independent JSON. Discriminate on kind.
kind: "span"){"kind":"span","traceId":"abc123","spanId":"def456","parentSpanId":"","name":"ConnectionService.getConnection","spanKind":1,"startTimeUnixNano":"1779461510277547833","endTimeUnixNano":"1779461510278117291","attributes":{"orgId":"00D..."},"events":[],"links":[],"status":{"code":1,"message":""},"resource":{"attributes":{"extension.name":"salesforcedx-vscode-core","service.name":"salesforcedx-vscode-core"}},"instrumentationScope":{"name":"salesforcedx-vscode-core","version":"2026-03-02T01:00.304Z"}}| Field | Notes |
|---|---|
parentSpanId: "" | Root span |
status.code | 1=OK, 2=ERROR |
spanKind | OTEL SpanKind +1 (1=INTERNAL, 2=SERVER, 3=CLIENT) |
resource.attributes["extension.name"] | Emitting extension |
| Duration (ms) | (endTimeUnixNano - startTimeUnixNano) / 1_000_000 |
Identity attrs (userId, cliId, webUserId, orgId, common.*) stamped only on root spans — child spans have them null; not a gap. Mirrors the App Insights properties exactly. userId absent for expired/unauthenticated orgs. Note: an internal diagnostic child span (maybeUpdateDefaultOrgRef) annotates the literal string "undefined" when SOQL userId is unresolved — that string never reaches exported root spans (filtered out).
f=$(ls -t ~/.sf/vscode-spans/*.jsonl | head -1)
jq -rc 'select(.kind=="span" and .parentSpanId=="") | {name, userId:.attributes.userId, cliId:.attributes.cliId, webUserId:.attributes.webUserId, orgId:.attributes.orgId}' "$f" | sort -ukind: "log"){"kind":"log","timestamp":"1779463981397000000","severityText":"WARN","severityNumber":30000,"body":"UserIdNotFoundError: Could not determine user ID","traceId":"b4d710...","spanId":"706dfc...","attributes":{"fiberId":"#295"}}| Field | Notes |
|---|---|
traceId + spanId | Span active when log emitted |
severityText | INFO, WARN, ERROR (filtered by logLevel) |
body | String or array (multiple args) |
timestamp | Nanos since epoch |
{
"salesforcedx-vscode-salesforcedx.enableFileTraces": true,
"salesforcedx-vscode-salesforcedx.logLevel": "info"
}Hosted Web Console cannot write this dir. Local OTLP (enableLocalTraces → :4318) → web-console-local-traces.
Web POSTs to local span file server (port 3003). Server must run.
npm run spans:server -w salesforcedx-vscode-services.esbuild-web-extra-settings.json at repo root (gitignored):{ "salesforcedx-vscode-salesforcedx.enableFileTraces": true }npm run run:web -w packages/<extension>Inspect App Insights telemetry each platform would send to Azure — captured locally, never sent. Output: ~/.sf/vscode-appinsights/ (separate from spans), via same server (port 3003).
| Platform | Trigger | Exporter | Endpoint | File prefix |
|---|---|---|---|---|
| Desktop (Node) | Dev/Test mode (auto); custom port via SF_OTEL_INGESTION_ENDPOINT | Azure Monitor | /v2.1/track | appinsights- |
| Web | ESBUILD_WEB_LOCAL=1 (auto under run:web) | @vscode/extension-telemetry | /v2.1/track | appinsights-web- |
Start server first: npm run spans:server -w salesforcedx-vscode-services
Extension via --extensionDevelopmentPath (F5, vscode-test, Playwright desktop e2e) = ExtensionMode.Development/Test, which auto-diverts App Insights to http://localhost:3003/v2.1/track — no env var or setting. Telemetry force-enabled (provably can't reach Azure).
Custom port: SF_OTEL_INGESTION_ENDPOINT=http://localhost:NNNN.
Divert Mechanism: Connection string stays pristine. Both FilteredAzureMonitorTraceExporter (dependencies path) and ApplicationInsightsNodeExporter (customEvents path) swap their private HTTP transport to POST Breeze envelopes over plain HTTP to {localIngestionEndpoint}/v2.1/track. Why swap transport? The Azure SDK's ConnectionStringParser.sanitizeUrl force-upgrades http:// → https://, blocking plain-HTTP localhost servers.
Server gzip-decompresses, writes raw Breeze envelopes (exact wire format Azure receives). Top-level keys: name, time, instrumentationKey, sampleRate, tags, version, data. No iKey, no target. Custom dimensions (IDs, common.*) live in data.baseData.properties, NOT directly under baseData:
{"name":"Microsoft.ApplicationInsights.RemoteDependency","time":"2026-06-15T15:44:24.223Z","instrumentationKey":"f5cbbeba-...","sampleRate":100,"version":1,"tags":{"ai.cloud.role":"salesforcedx-vscode-core","ai.operation.id":"f2da4484..."},"data":{"baseType":"RemoteDependencyData","baseData":{"name":"ConnectionService.getConnection","id":"1250a85f...","success":true,"resultCode":"0","duration":"00:00:00.001","properties":{"common.extname":"salesforcedx-vscode-core","cliId":"00d6...","webUserId":"701b...","userId":"005..."},"measurements":{}}}}Filename: appinsights-{ISO-timestamp}.jsonl. data.baseType: RemoteDependencyData (span path), MetricData, ExceptionData, or EventData (customEvents path).
| Field | Notes |
|---|---|
instrumentationKey | connection key (NOT iKey) |
tags["ai.cloud.role"] | emitting extension |
data.baseData.properties | custom dimensions: cliId, webUserId, userId, common.*, telemetryTag |
Identity lands only on root spans (spanTransformProcessor gates on !span.parentSpanContext) → most envelopes/spans lack IDs; that's expected, not a gap. userId (SOQL-derived) is absent until an org is authenticated and the query resolves; absent for expired orgs. cliId/webUserId are install-stable, present once seedTelemetryIdentities runs at activation — activation spans firing before that seeding are bare.
customEvents path (EventData, via ApplicationInsightsNodeExporter) only emits when an extension's packageJSON sets enableCustomEventsFromSpans. None do today — so only the dependencies path (RemoteDependencyData) appears.
Useful queries:
g=$(ls -t ~/.sf/vscode-appinsights/*.jsonl | head -1)
jq -rc '.data.baseType' "$g" | sort | uniq -c # envelope mix
jq -rc 'select(.data.baseType=="RemoteDependencyData") | {name:.data.baseData.name, role:.tags["ai.cloud.role"], userId:.data.baseData.properties.userId, cliId:.data.baseData.properties.cliId, webUserId:.data.baseData.properties.webUserId}' "$g"npm run run:web builds via vscode:bundle:local, setting ESBUILD_WEB_LOCAL=1 — web exporter POSTs to http://localhost:3003/v2.1/track (shared Node endpoint). (SF_OTEL_INGESTION_ENDPOINT has no effect on web: connection string hard-coded.)
Payload is not Breeze — it's the @vscode/extension-telemetry shape:
{"name":"ConnectionService.getConnection","eventType":"event","properties":{"orgId":"00D...","common.extname":"salesforcedx-vscode-core"},"measurements":{"duration":42}}Filename: appinsights-web-{ISO-timestamp}.jsonl. eventType: event (success) or errorEvent (failed span).
npm run spans:server -w salesforcedx-vscode-servicesnpm run run:web -w packages/<extension> (auto).cat ~/.sf/vscode-appinsights/*.jsonl | jq '.' | lessrm ~/.sf/vscode-appinsights/*
Logs reference active span via traceId + spanId. Reconstruct:
traceIdparentSpanId → childrentraceId — belong to span matching their spanId© forcedotcom, BSD-3-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Just SKILL.md in .claude/skills/span-file-export of forcedotcom/salesforcedx-vscode.
Open the folder on GitHubat commit 27807f6
Span File Export next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Span File Export this skillforcedotcom/salesforcedx-vscode | 1k | — | ~2.2k | Automated safety check: Pass | BSD-3-Clause | |
| Motel Debugkitlangton/motel | 298 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Aspire Service DefaultsAaronontheweb/dotnet-skills | 1.2k | 1 repos | ~2.6k | Automated safety check: Pass | MIT | |
| Sentry Advanced Troubleshootingjeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~3.7k | Automated safety check: Pass | MIT | |
| Tempsgotempsh/temps | 826 | — | ~1.9k | Automated safety check: Pass | Apache-2.0 | |
| UModel Root Cause Analysisalibaba/UnifiedModel | 412 | — | ~1.9k | Automated safety check: Pass | Custom licence |
kitlangton/motel
Debug applications with motel, a local OpenTelemetry ingest and query server.
Aaronontheweb/dotnet-skills
Sets up a shared ServiceDefaults project for .NET Aspire apps that centralizes OpenTelemetry, health checks, HTTP resilience and service discovery for every service.
jeremylongshore/tons-of-skills-marketplace
Advanced Sentry troubleshooting for complex SDK issues, silent event drops, source map failures, distributed tracing gaps, and SDK conflicts.
gotempsh/temps
Manage, deploy, operate, and instrument applications with Temps.
alibaba/UnifiedModel
Investigates a service incident to its root cause by querying a UModel object graph alongside metrics, logs, topology and recent deployments.
vivekchand/clawmetry
Give the human an off switch and a cost meter for the coding agents on this machine, using ClawMetry.
forcedotcom/salesforcedx-vscode
Command palette, CodeLens, context menus, package.nls titles, and NotificationModeService.
forcedotcom/salesforcedx-vscode
Consume the salesforcedx-vscode-services extension API. An agent skill from forcedotcom/salesforcedx-vscode.
forcedotcom/salesforcedx-vscode
Polish the automated CHANGELOG on develop before the next stable build.
forcedotcom/salesforcedx-vscode
Public API exported by salesforcedx-vscode-core activate(). An agent skill from forcedotcom/salesforcedx-vscode.
forcedotcom/salesforcedx-vscode
Operate a real VS Code instance through drivable-vscode. An agent skill from forcedotcom/salesforcedx-vscode.
forcedotcom/salesforcedx-vscode
Enforces Effect-TS patterns for services, errors, layers, atoms, and Effect.pipe composition.
Works with
Categories
Use file-based span/log export for AI consumption. An agent skill from forcedotcom/salesforcedx-vscode. Span File Export is an agent skill from forcedotcom/salesforcedx-vscode. Use file-based span/log export for AI consumption.
Span File Export fits situations like: enabling span file dump; debugging traces for AI; configuring local observability.
Run `npx skills add forcedotcom/salesforcedx-vscode --skill span-file-export -a claude-code`. Or copy the skill folder (.claude/skills/span-file-export in forcedotcom/salesforcedx-vscode) into .claude/skills/span-file-export in your project. Claude Code loads it when a task matches its description.
Run `npx skills add forcedotcom/salesforcedx-vscode --skill span-file-export -a codex`. Or copy the skill folder (.claude/skills/span-file-export in forcedotcom/salesforcedx-vscode) into .agents/skills/span-file-export in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add forcedotcom/salesforcedx-vscode --skill span-file-export -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/span-file-export, .gemini/skills/span-file-export, .github/skills/span-file-export and .opencode/skills/span-file-export in your project.
Going by SKILL.md and its folder, Span File Export needs the command-line tools its instructions call (npm and jq).
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Span File Export is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.2k tokens (SKILL.md is roughly 8.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Span File Export: Motel Debug (kitlangton/motel, 298 stars), Aspire Service Defaults (Aaronontheweb/dotnet-skills, 1.2k stars), Sentry Advanced Troubleshooting (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Temps (gotempsh/temps, 826 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
forcedotcom (a GitHub organization) maintains it in forcedotcom/salesforcedx-vscode, which has 1,035 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on October 8, 2026.
Source: forcedotcom/salesforcedx-vscode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.