New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Customizing Statusline

by letta-ai in letta-ai/letta-code

Creates, edits, and migrates Letta Code statusline mods. An agent skill from letta-ai/letta-code.

Apache-2.0Auto-check passed

Install Customizing Statusline

skills CLI
$ npx skills add letta-ai/letta-code --skill customizing-statusline -a claude-code

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

GitHub CLI
$ gh skill install letta-ai/letta-code customizing-statusline --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/letta-ai/letta-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/src/skills/builtin/customizing-statusline .claude/skills/customizing-statusline && 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
customizing-statusline
GitHub stars
3.6k
Token cost
~834 tokens
SKILL.md length
430 words
Files
4 (incl. references)
Skills in repo
25
Repo updated
First seen
Licence
Apache-2.0

At a glance

Creates, edits, and migrates Letta Code statusline mods. An agent skill from letta-ai/letta-code.

  • Works in 9 steps: Check whether… → If it exists, read it before editing and… → If it does not exist, synthesize a… → …
  • Handling the /statusline command
  • SKILL.md covers Statusline ownership model, Workflow, Bare /statusline behavior and Rules, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Customizing Statusline is an agent skill from letta-ai/letta-code. Creates, edits, and migrates Letta Code statusline mods. Use when handling the /statusline command or continuing work started by /statusline.

Its SKILL.md is about 830 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/api.md`, `references/examples.md` and `references/migration.md`).

It works with Letta. The repository describes itself as: Stateful agents that are like people, with memory, identity, and the ability to learn and adapt. The licence is Apache-2.0.

When your agent uses it

  • Handling the /statusline command
  • Continuing work started by /statusline

Example prompts

  • “/customizing-statusline”

Workflow steps

9 steps, taken from the first numbered list in SKILL.md.

  1. Check whether ~/.letta/mods/statusline.tsx exists.
  2. If it exists, read it before editing and preserve unrelated code.
  3. If it does not exist, synthesize a focused starter for the user's request.
  4. If the user asks to migrate, import a .sh file, or match a shell prompt, read references/migration.md.
  5. If API details or concrete patterns are needed, read references/api.md and references/examples.md.
  6. If the request combines statusline work with commands, tools, events, other panels, or stateful mod behavior, also use creating-mods and…
  7. Guard panel work with letta.capabilities.ui.panels when writing new files.
  8. Edit ~/.letta/mods/statusline.tsx.
  9. Summarize the absolute file path changed and tell the user to run /reload unless the command can reload automatically.

What it can do on your machine

Read from SKILL.md and the folder at commit d31b879. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Customizing Statusline loads about 834 tokens when it runs, and up to ~4k if it reads all its reference files. Until then it costs about 41 tokens; SKILL.md has 430 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~41
When it runs · the whole SKILL.md, loaded when a task matches
~834
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4k

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 letta-ai/letta-code at commit d31b879, republished under its Apache-2.0 licence (© letta-ai). 430 words, ~834 tokens.

Download SKILL.mdSave it as .claude/skills/customizing-statusline/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
customizing-statusline
description
Creates, edits, and migrates Letta Code statusline mods. Use when handling the /statusline command or continuing work started by /statusline.

Customizing Statusline

Use this skill to create or update the global Letta Code statusline mod:

text
~/.letta/mods/statusline.tsx

The statusline is a panel registered at order: 0 — the primary line just below the input. It overrides the built-in agent · model line. Host UI can still temporarily preempt it for safety confirmations and transient hints.

Statusline ownership model

text
safety preemption
else transient host hint
else order-0 statusline panel
else built-in default statusline

The order-0 panel owns the whole primary row. It renders text (not React) and owns its own layout via the row/columns helpers.

Workflow

  1. Check whether ~/.letta/mods/statusline.tsx exists.
  2. If it exists, read it before editing and preserve unrelated code.
  3. If it does not exist, synthesize a focused starter for the user's request.
  4. If the user asks to migrate, import a .sh file, or match a shell prompt, read references/migration.md.
  5. If API details or concrete patterns are needed, read references/api.md and references/examples.md.
  6. If the request combines statusline work with commands, tools, events, other panels, or stateful mod behavior, also use creating-mods and its references/architecture.md.
  7. Guard panel work with letta.capabilities.ui.panels when writing new files.
  8. Edit ~/.letta/mods/statusline.tsx.
  9. Summarize the absolute file path changed and tell the user to run /reload unless the command can reload automatically.

Bare /statusline behavior

If the user ran /statusline without a specific request:

  • If a custom statusline file exists, summarize what it appears to do and ask what they want to change.
  • If no custom file exists, explain that Letta is using the built-in default statusline and offer focused next steps:
    1. start from a simple agent · model statusline
    2. add project info like git branch, worktree, or PR
    3. migrate an existing legacy statusline .sh file
    4. match shell prompt / PS1
    5. describe a custom statusline in their own words

Keep this conversational. Do not build a menu UI unless the product command explicitly asks for one.

Show full SKILL.md (128 more words)Show less

Rules

  • Global-only for now. Do not create project mods.
  • Keep the mod single-file for MVP.
  • Do not assume extra npm packages are available.
  • Do not use relative multi-file imports yet.
  • Keep render synchronous and side-effect-free. Do not shell, fetch, await, or read files inside render.
  • Do async work in setup code, intervals, or subscriptions, store the result in a closure variable, then call panel.update() to re-render.
  • Register the statusline at order: 0. Compose left/right with row(left, right, width); color with chalk.
  • Guard panel work with letta.capabilities.ui.panels in new files.
  • Return a disposer that clears timers/subscriptions and calls panel.close().
  • Preserve existing mod code unless the user asks to reset.

Useful references

  • references/api.md - panel API, render context, lifecycle rules
  • references/examples.md - common statusline patterns
  • references/migration.md - legacy command .sh and PS1 migration

© letta-ai, Apache-2.0. 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 3 other files (references) in src/skills/builtin/customizing-statusline of letta-ai/letta-code.

  • SKILL.md
  • references/api.md
  • references/examples.md
  • references/migration.md

Open the folder on GitHubat commit d31b879

Compare with similar skills

Customizing Statusline 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.

Customizing Statusline compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Customizing Statusline this skillletta-ai/letta-code3.6k—~834Automated safety check: PassApache-2.0
Lettabotletta-ai/lettabot327—~3.4kAutomated safety check: PassApache-2.0
Creating Letta Code Channelsletta-ai/skills149—~1.1kAutomated safety check: PassMIT
Letta Configurationletta-ai/skills149—~1.3kAutomated safety check: NotesMIT
Letta Filesystem To Memfsletta-ai/skills149—~1.3kAutomated safety check: PassMIT
Navigating Chatgpt Historyletta-ai/skills149—~1.3kAutomated safety check: PassMIT

Similar skills

  • Lettabot

    letta-ai/lettabot

    Set up and run LettaBot - a multi-channel AI assistant for Telegram, Slack, Discord, WhatsApp, and Signal.

    327 GitHub stars~3.4k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed

  • Creating Letta Code Channels

    letta-ai/skills

    Builds and debugs Letta Code channels, including first-party channel adapters and dynamic user channel plugins under ~/.letta/channels.

    149 GitHub stars~1.1k tokensUpdated 8 days ago
    Writing & ContentAuto-check passed

  • Letta Configuration

    letta-ai/skills

    Configure LLM models and providers for Letta agents and servers.

    149 GitHub stars~1.3k tokensUpdated 8 days ago
    DevOps & CloudAuto-check: notes

  • Letta Filesystem To Memfs

    letta-ai/skills

    Migrates deprecated Letta Filesystem folders/files to MemFS using markdown document corpora, chunking, local lexical search, and QMD semantic search via the memfs-search skill.

    149 GitHub stars~1.3k tokensUpdated 8 days ago
    Documents & OfficeAuto-check passed

  • Navigating Chatgpt History

    letta-ai/skills

    Navigates archived ChatGPT or Claude-style conversation exports and a MemFS reference archive on demand.

    149 GitHub stars~1.3k tokensUpdated 8 days ago
    Auto-check passed

  • Self Configuration

    letta-ai/skills

    Configures Letta agents' own runtime behavior, including model, context window, system prompt, reasoning, conversation overrides, compaction settings, and compaction prompts.

    149 GitHub stars~2.4k tokensUpdated 8 days ago
    AI & LLM EngineeringAuto-check passed

More from letta-ai/letta-code

All 25 skills in this repo

  • Creating Skills

    letta-ai/letta-code

    Guide for creating effective skills. An agent skill from letta-ai/letta-code.

    3.6k GitHub stars~4.6k tokensUpdated today
    Auto-check passed

  • Generating Mod Envs

    letta-ai/letta-code

    Generates and reviews mod learning env JSON files for Letta Code local mods.

    3.6k GitHub stars~1.5k tokensUpdated today
    Auto-check passed

  • Initializing Memory

    letta-ai/letta-code

    Comprehensive guide for initializing or reorganizing agent memory.

    3.6k GitHub stars~4.8k tokensUpdated today
    Auto-check passed

  • Self Configuration

    letta-ai/letta-code

    Inspect or modify Letta Code's own memory, model, context window, system prompt, compaction, permissions, toolsets, mods, skills, channels, schedules, agent secrets, and local runtime settings.

    3.6k GitHub stars~7k tokensUpdated today
    Auto-check passed

  • Browser Use

    letta-ai/letta-code

    Control a real browser to navigate pages, click, type, fill forms, inspect rendered UI, take screenshots, or record video.

    3.6k GitHub stars~3.3k tokensUpdated today
    Auto-check passed

  • Creating Mods

    letta-ai/letta-code

    Creates and edits trusted local Letta Code mods, including tools, slash commands, local-only model providers, lifecycle/turn events, scoped conversation helpers, panels, and capability-gated behavior.

    3.6k GitHub stars~2.5k tokensUpdated today
    Auto-check passed

Works with

Questions about Customizing Statusline

What does Customizing Statusline do?

Creates, edits, and migrates Letta Code statusline mods. An agent skill from letta-ai/letta-code. Customizing Statusline is an agent skill from letta-ai/letta-code. Creates, edits, and migrates Letta Code statusline mods.

When should I use Customizing Statusline?

Customizing Statusline fits situations like: handling the /statusline command; continuing work started by /statusline.

How do I install Customizing Statusline in Claude Code?

Run `npx skills add letta-ai/letta-code --skill customizing-statusline -a claude-code`. Or copy the skill folder (src/skills/builtin/customizing-statusline in letta-ai/letta-code) into .claude/skills/customizing-statusline in your project. Claude Code loads it when a task matches its description.

How do I install Customizing Statusline in Codex?

Run `npx skills add letta-ai/letta-code --skill customizing-statusline -a codex`. Or copy the skill folder (src/skills/builtin/customizing-statusline in letta-ai/letta-code) into .agents/skills/customizing-statusline in your project. Codex loads it when a task matches its description.

Can I use Customizing Statusline 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 letta-ai/letta-code --skill customizing-statusline -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/customizing-statusline, .gemini/skills/customizing-statusline, .github/skills/customizing-statusline and .opencode/skills/customizing-statusline in your project.

What does Customizing Statusline need to run?

SKILL.md names no scripts, command-line tools or credentials: Customizing Statusline is instructions for the agent only.

Does Customizing Statusline 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 Customizing Statusline 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 Customizing Statusline use?

Customizing Statusline is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Customizing Statusline use?

About 834 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.1k tokens, read only when the agent opens those files.

What are the alternatives to Customizing Statusline?

Skills that share tags, products or a category with Customizing Statusline: Lettabot (letta-ai/lettabot, 327 stars), Creating Letta Code Channels (letta-ai/skills, 149 stars), Letta Configuration (letta-ai/skills, 149 stars) and Letta Filesystem To Memfs (letta-ai/skills, 149 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Customizing Statusline?

letta-ai (a GitHub organization) maintains it in letta-ai/letta-code, which has 3,562 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 10, 2026.

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