Agent skill

Tt Sidebar

by stormzhang in stormzhang/token-tracker

Open a live Token Tracker sidebar for only the current Codex session in a right-side terminal split at one-third width.

MITAuto-check passed

Install Tt Sidebar

skills CLI
$ npx skills add stormzhang/token-tracker --skill tt-sidebar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install stormzhang/token-tracker tt-sidebar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/stormzhang/token-tracker.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/token_tracker/skills/tt_sidebar .claude/skills/tt-sidebar && rm -rf skills-src

Use ~/.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/

Facts

Skill name
tt-sidebar
GitHub stars
528
Token cost
~440 tokens
SKILL.md length
200 words
Files
3
Skills in repo
2
Repo updated
First seen
Licence
MIT

At a glance

Open a live Token Tracker sidebar for only the current Codex session in a right-side terminal split at one-third width.

  • The user explicitly invokes $tt-sidebar
  • Runs Python scripts from its folder
  • Asks to monitor the current Codex session beside its terminal pane

What it does

Tt Sidebar is an agent skill from stormzhang/token-tracker. Open a live Token Tracker sidebar for only the current Codex session in a right-side terminal split at one-third width. Use when the user explicitly invokes $tt-sidebar or asks to monitor the current Codex session beside its terminal pane.

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `__init__.py` and `agents/openai.yaml`).

It works with Python and tmux. The repository describes itself as: Claude Code & Codex 本地 token 追踪 — 状态栏(Codex 业界首创伪 statusline)、GitHub 风格热力图、多模型成本分析。 | Local token tracker for Claude Code & Codex — status line (industry-first Codex faux…. The licence is MIT.

When your agent uses it

  • The user explicitly invokes $tt-sidebar
  • Asks to monitor the current Codex session beside its terminal pane

Example prompts

  • “/tt-sidebar”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 2ac54f9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    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.

  • Runs code

    Ships script files (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tt Sidebar loads about 440 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 200 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~440

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.

Safety

Auto-check passed

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.

SKILL.md

The full file from stormzhang/token-tracker at commit 2ac54f9, republished under its MIT licence (© stormzhang). 200 words, ~440 tokens.

Download SKILL.mdSave it as .claude/skills/tt-sidebar/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
tt-sidebar
description
Open a live Token Tracker sidebar for only the current Codex session in a right-side terminal split at one-third width. Use when the user explicitly invokes $tt-sidebar or asks to monitor the current Codex session beside its terminal pane.

TT Sidebar

<!-- token-tracker-managed -->

Run the installed launcher exactly once:

bash
__TT_SIDEBAR_COMMAND__

Choose execution permissions from the current terminal environment before running it:

  • On iTerm2 (ITERM_SESSION_ID set, with no TMUX_PANE), run the launcher outside the Codex sandbox by setting sandbox_permissions to require_escalated. Set justification to ask whether Token Tracker may control iTerm2 to create the sidebar pane. If reusable approval is supported, set prefix_rule to the complete launcher argv above; never approve Python generally. Do not first try the iTerm2 launcher inside the sandbox: macOS may hide iTerm2's AppleScript dictionary and misreport error -2741.
  • On Ghostty (TERM_PROGRAM=ghostty, macOS, Ghostty ≥ 1.3.0), apply the same escalated execution as iTerm2: the launcher drives Ghostty's AppleScript split and the sandbox may hide Ghostty's scripting dictionary and misreport error -2741.
  • On tmux (TMUX_PANE set), run the launcher with normal sandbox permissions.

Return the launcher's output directly. Do not run regular tt sidebar, inject a command into a transient shell, or open another sidebar in the current pane. If the launcher fails, report only its concise stage error.

The launcher must keep the source pane focused and open a right-side pane at one-third width. The split view is current-session-only and is intentionally independent from the regular all-session tt sidebar layout.

© stormzhang, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in src/token_tracker/skills/tt_sidebar of stormzhang/token-tracker.

  • SKILL.md
  • __init__.py
  • agents/openai.yaml

Open the folder on GitHubat commit 2ac54f9

Compare with similar skills

Tt Sidebar 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.

Tt Sidebar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Tt Sidebar this skillstormzhang/token-tracker528—~440Automated safety check: PassMIT
Git History Bug Auditben-manes/caffeine18k—~3.3kAutomated safety check: PassApache-2.0
Using Tmux For Interactive Commandsobra/superpowers-lab4302 repos~1.3kAutomated safety check: PassMIT
Pypi ReleasealchemiststudiosDOTai/tunacode125—~2.2kAutomated safety check: PassMIT
Term CLIEliasOenal/term-cli104—~3.3kAutomated safety check: PassBSD-3-Clause-Clear
Nerd Font Icon Lookupmalob/nix-config463—~697Automated safety check: PassMIT

Similar skills

  • Git History Bug Audit

    ben-manes/caffeine

    Audits a module by walking its git history commit by commit, tracking unresolved issues forward, and reporting the ones that survive to HEAD as findings.

    18k GitHub stars~3.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • A skill your agent uses when you need to run interactive CLI tools (vim, git rebase -i, Python REPL, etc.) that require real-time input/output - provides tmux-based approach for controlling…

    430 GitHub starsUsed in 2 repos~1.3k tokens
    DevelopmentAuto-check passed
  • Pypi Release

    alchemiststudiosDOTai/tunacode

    This skill should be used when releasing tunacode-cli to PyPI.

    125 GitHub stars~2.2k tokensUpdated 4 days ago
    DevelopmentAuto-check passed
  • Term CLI

    EliasOenal/term-cli

    Controls interactive terminal sessions for running long-lived processes, servers, REPLs, debuggers, and TUI programs without blocking.

    104 GitHub stars~3.3k tokensUpdated 2 mo ago
    DatabasesAuto-check passed
  • Nerd Font Icon Lookup

    malob/nix-config

    Works around Claude Code filtering private-use Unicode so agents can read and write Nerd Font icons in Starship, tmux and prompt configs.

    463 GitHub stars~697 tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Tmux Bridge

    tmustier/pi-for-excel

    Local terminal access via the tmux bridge. An agent skill from tmustier/pi-for-excel.

    434 GitHub stars~819 tokensUpdated yesterday
    Documents & OfficeAuto-check passed

More from stormzhang/token-tracker

  • Tt Sidebar

    stormzhang/token-tracker

    Open a live Token Tracker sidebar for only the current Kimi Code session in a right-side terminal split at one-third width.

    528 GitHub stars~280 tokensUpdated 5 days ago
    Auto-check passed

Works with

Questions about Tt Sidebar

What does Tt Sidebar do?

Open a live Token Tracker sidebar for only the current Codex session in a right-side terminal split at one-third width. Tt Sidebar is an agent skill from stormzhang/token-tracker. Open a live Token Tracker sidebar for only the current Codex session in a right-side terminal split at one-third width.

When should I use Tt Sidebar?

Tt Sidebar fits situations like: the user explicitly invokes $tt-sidebar; asks to monitor the current Codex session beside its terminal pane.

How do I install Tt Sidebar in Claude Code?

Run `npx skills add stormzhang/token-tracker --skill tt-sidebar -a claude-code`. Or copy the skill folder (src/token_tracker/skills/tt_sidebar in stormzhang/token-tracker) into .claude/skills/tt-sidebar in your project. Claude Code loads it when a task matches its description.

How do I install Tt Sidebar in Codex?

Run `npx skills add stormzhang/token-tracker --skill tt-sidebar -a codex`. Or copy the skill folder (src/token_tracker/skills/tt_sidebar in stormzhang/token-tracker) into .agents/skills/tt-sidebar in your project. Codex loads it when a task matches its description.

Can I use Tt Sidebar in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add stormzhang/token-tracker --skill tt-sidebar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tt-sidebar, .gemini/skills/tt-sidebar, .github/skills/tt-sidebar and .opencode/skills/tt-sidebar in your project.

What does Tt Sidebar need to run?

Going by SKILL.md and its folder, Tt Sidebar needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Tt Sidebar access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tt Sidebar safe to install?

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.

What licence does Tt Sidebar use?

Tt Sidebar is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tt Sidebar use?

About 440 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Tt Sidebar?

Skills that share tags, products or a category with Tt Sidebar: Git History Bug Audit (ben-manes/caffeine, 18k stars), Using Tmux For Interactive Commands (obra/superpowers-lab, 430 stars), Pypi Release (alchemiststudiosDOTai/tunacode, 125 stars) and Term CLI (EliasOenal/term-cli, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tt Sidebar?

stormzhang (a GitHub user) maintains it in stormzhang/token-tracker, which has 528 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 4, 2026.

Source: stormzhang/token-tracker on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.