upload-transcript

Upload Claude Code session .jsonl transcripts to ace-web with authentication.

1|2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/dimagi-internal/ace --skill upload-transcript-dimagi-internal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: upload-transcript
Source: https://github.com/dimagi-internal/ace/tree/main/skills/upload-transcript
Command: npx skills add https://github.com/dimagi-internal/ace --skill upload-transcript-dimagi-internal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When running ACE lifecycle workflows, Claude Code generates per-session .jsonl transcript logs that need to be uploaded to a deployed ace-web instance to be viewable as chat sessions, attributed to the correct user, and linked to specific ACE opportunities for context in the Workbench. Manually locating and uploading these transcripts is tedious, error-prone, and often results in unlinked or misattributed session records.

Core Features & Use Cases

  • Auto-Discovery of Transcripts: Automatically finds the current Claude Code session .jsonl log if no explicit file path is provided, eliminating the need to manually locate session files.
  • Authenticated Uploads: Uses per-human Bearer Personal Access Tokens (PATs) to authenticate uploads to ace-web, ensuring sessions are correctly attributed to the user who minted the token.
  • Opportunity Linking: Supports linking uploaded transcripts to specific ACE opportunity slugs, run IDs, and skill steps, so sessions surface directly in the Workbench's linked chats panel for the relevant opportunity.
  • Use Case: When running an ACE lifecycle with the /ace:run --ace-web-url flag, this skill automatically uploads the session transcript after the run completes, so your team can review the full chat context tied to that specific opportunity run directly in ace-web.

Quick Start

Use the upload-transcript skill to upload your current Claude session transcript to your deployed ace-web instance and link it to the active ACE opportunity.

Frequently Asked Questions about upload-transcript

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload Claude Code session transcripts to ace-web?

To upload Claude Code session transcripts, you use the upload-transcript skill to send .jsonl log files to your deployed ace-web instance, where they are rendered as viewable, attributed chat sessions. It supports auto-discovery of the current session log.

Do I need a token to authenticate session uploads to the ace-web Workbench?

Yes, authenticated uploads to the ace-web Workbench require a valid ACE_WEB_PAT_TOKEN. This Bearer Personal Access Token ensures uploaded Claude Code session transcripts are correctly attributed to the user who minted the token.

How do I link uploaded Claude .jsonl transcripts to specific ACE opportunities?

Linking uploaded Claude .jsonl transcripts to specific ACE opportunities requires specifying an opportunity slug, run ID, and skill step during the upload process. This surfaces the sessions directly in the Workbench's linked chats panel for team review.

Can I automatically find the current Claude Code session log file?

Yes, auto-discovery of the current Claude Code session log is supported. If you do not provide an explicit file path, the upload-transcript skill automatically finds the current .jsonl session log file for upload to ace-web.

Why do Django Ninja upload binding errors occur when uploading transcripts?

Django Ninja upload binding errors can occur during transcript uploads due to incorrect multipart form field ordering. The upload-transcript skill enforces correct multipart form field ordering to prevent these Django Ninja upload binding errors.

When should I use the upload-transcript skill for ACE lifecycle workflows?

Use the upload-transcript skill for ACE lifecycle workflows when you run /ace:run with the --ace-web-url flag. It automatically uploads the session transcript after the run completes, linking the chat context to that specific opportunity run for team review.