Tokopt Upload

tokopt-upload

Upload your Claude Code conversation logs for cost analysis and waste detection. No account needed.

Quick Start

# One-liner — upload and get your dashboard link
curl -fsSL https://tokopt.online/scripts/tokopt-upload.sh | bash

Or clone and run:

git clone https://github.com/tokopt/tokopt-upload.git
cd tokopt-upload
bash scripts/tokopt-upload.sh

As a Claude Code Skill

Skills are installed by cloning into the skills directory — no special CLI command needed.

Personal skill (available in all your projects)

mkdir -p ~/.claude/skills
git clone https://github.com/tokopt/tokopt-upload.git ~/.claude/skills/tokopt-upload

Project skill (shared with your team via git)

# Option A: Clone directly into the project
mkdir -p .claude/skills
git clone https://github.com/tokopt/tokopt-upload.git .claude/skills/tokopt-upload

# Option B: Add as a git submodule
git submodule add https://github.com/tokopt/tokopt-upload.git .claude/skills/tokopt-upload

Team members get the skill automatically when they `git pull`.

After installation, use `/tokopt-upload` in any Claude Code session. Optionally pass a project name: `/tokopt-upload my-project`.

Directory Structure

tokopt-upload/
├── SKILL.md              # Skill definition (instructions for Claude)
├── README.md             # This file
├── scripts/
│   └── tokopt-upload.sh  # Upload script
└── LICENSE

What It Does

1. Discovers all Claude Code session files in ~/.claude/projects/
2. Uploads them (with subagent sessions) to TokOpt for analysis
3. Prints a dashboard link — analysis runs in the background on the server

Your data stays local until you run the script. Nothing is sent without your action.

Options

Flag	Description
--server URL	TokOpt server URL (default: https://tokopt.online)
--project NAME	Project name for this upload
--token TOKEN	Reuse an existing guest token