Строка статуса

Отображение пользовательской информации в нижней панели с помощью shell-команды.

Строка статуса позволяет запускать shell-команду, вывод которой отображается в левой части нижней панели. Команда получает структурированный JSON-контекст через stdin, поэтому может отображать информацию с учётом сессии: текущую модель, использование токенов, ветку git или любые другие данные, которые можно получить скриптом.


Single-line status (default approval mode — 1 row):
┌─────────────────────────────────────────────────────────────────┐
│  user@host ~/project (main) ctx:34%   🔒 docker | Debug | 67%  │  ← status line
└─────────────────────────────────────────────────────────────────┘

Multi-line status (up to 2 lines — 2 rows):
┌─────────────────────────────────────────────────────────────────┐
│  user@host ~/project (main) ctx:34%   🔒 docker | Debug | 67%  │  ← status line 1
│  ████████░░░░░░░░░░ 34% context                                │  ← status line 2
└─────────────────────────────────────────────────────────────────┘

Multi-line status + non-default mode (3 rows max):
┌─────────────────────────────────────────────────────────────────┐
│  user@host ~/project (main) ctx:34%   🔒 docker | Debug | 67%  │  ← status line 1
│  ████████░░░░░░░░░░ 34% context                                │  ← status line 2
│  auto-accept edits (shift + tab to cycle)                       │  ← mode indicator
└─────────────────────────────────────────────────────────────────┘

После настройки строка статуса заменяет стандартную подсказку ”? for shortcuts”. Сообщения с высоким приоритетом (подсказки выхода по Ctrl+C/D, Esc, режим vim INSERT) временно перекрывают строку статуса. Текст строки статуса обрезается, чтобы поместиться в доступную ширину.

Требования

Для парсинга JSON-входа рекомендуется jq (установка через brew install jq, apt install jq и т.д.)
Простые команды, не требующие JSON-данных (например, git branch --show-current), работают без jq

Быстрая настройка

Самый простой способ настроить строку статуса — команда /statusline. Она запускает агент настройки, который считывает конфигурацию PS1 вашего shell и генерирует соответствующую строку статуса:


/statusline

Вы также можете дать ему конкретные инструкции:


/statusline show model name and context usage percentage

Ручная настройка

Добавьте объект statusLine в ключ ui файла ~/.qwen/settings.json:


{
  "ui": {
    "statusLine": {
      "type": "command",
      "command": "input=$(cat); model=$(echo \"$input\" | jq -r '.model.display_name'); pct=$(echo \"$input\" | jq -r '.context_window.used_percentage'); echo \"$model  ctx:${pct}%\""
    }
  }
}

Поле	Тип	Обязательно	Описание
`type`	`"command"`	Да	Должно быть `"command"`
`command`	string	Да	Выполняемая shell-команда. Получает JSON через stdin, вывод (stdout) отображается (до 2 строк).
`refreshInterval`	number	Нет	Повторный запуск команды каждые N секунд (минимум 1). Полезно для данных, которые меняются без события состояния агента (часы, квота, время работы).

JSON-вход

Команда получает JSON-объект через stdin со следующими полями:


{
  "session_id": "abc-123",
  "version": "0.14.1",
  "model": {
    "display_name": "qwen-3-235b"
  },
  "context_window": {
    "context_window_size": 131072,
    "used_percentage": 34.3,
    "remaining_percentage": 65.7,
    "current_usage": 45000,
    "total_input_tokens": 30000,
    "total_output_tokens": 5000
  },
  "workspace": {
    "current_dir": "/home/user/project"
  },
  "git": {
    "branch": "main"
  },
  "metrics": {
    "models": {
      "qwen-3-235b": {
        "api": {
          "total_requests": 10,
          "total_errors": 0,
          "total_latency_ms": 5000
        },
        "tokens": {
          "prompt": 30000,
          "completion": 5000,
          "total": 35000,
          "cached": 10000,
          "thoughts": 2000
        }
      }
    },
    "files": {
      "total_lines_added": 120,
      "total_lines_removed": 30
    }
  },
  "vim": {
    "mode": "INSERT"
  }
}

Поле	Тип	Описание
`session_id`	string	Уникальный идентификатор сессии
`version`	string	Версия Qwen Code
`model.display_name`	string	Имя текущей модели
`context_window.context_window_size`	number	Общий размер контекстного окна в токенах
`context_window.used_percentage`	number	Использование контекстного окна в процентах (0–100)
`context_window.remaining_percentage`	number	Оставшееся место в контекстном окне в процентах (0–100)
`context_window.current_usage`	number	Количество токенов из последнего API-запроса (текущий размер контекста)
`context_window.total_input_tokens`	number	Общее количество входных токенов, потреблённых за сессию
`context_window.total_output_tokens`	number	Общее количество выходных токенов, потреблённых за сессию
`workspace.current_dir`	string	Текущий рабочий каталог
`git`	object \| absent	Присутствует только внутри git-репозитория.
`git.branch`	string	Имя текущей ветки
`metrics.models.<id>.api`	object	Статистика API по моделям: `total_requests`, `total_errors`, `total_latency_ms`
`metrics.models.<id>.tokens`	object	Использование токенов по моделям: `prompt`, `completion`, `total`, `cached`, `thoughts`
`metrics.files`	object	Статистика изменений файлов: `total_lines_added`, `total_lines_removed`
`vim`	object \| absent	Присутствует только при включённом режиме vim. Содержит `mode` (`"INSERT"` или `"NORMAL"`).

Важно: stdin можно прочитать только один раз. Всегда сначала сохраняйте его в переменную: input=$(cat).

Примеры

Модель и использование токенов


{
  "ui": {
    "statusLine": {
      "type": "command",
      "command": "input=$(cat); model=$(echo \"$input\" | jq -r '.model.display_name'); pct=$(echo \"$input\" | jq -r '.context_window.used_percentage'); echo \"$model  ctx:${pct}%\""
    }
  }
}

Вывод: qwen-3-235b ctx:34%

Ветка git + каталог


{
  "ui": {
    "statusLine": {
      "type": "command",
      "command": "input=$(cat); branch=$(echo \"$input\" | jq -r '.git.branch // empty'); dir=$(basename \"$(echo \"$input\" | jq -r '.workspace.current_dir')\"); echo \"$dir${branch:+ ($branch)}\""
    }
  }
}

Вывод: my-project (main)

Примечание: Поле git.branch предоставляется напрямую в JSON-входе — нет необходимости вызывать git через shell.

Статистика изменений файлов


{
  "ui": {
    "statusLine": {
      "type": "command",
      "command": "input=$(cat); added=$(echo \"$input\" | jq -r '.metrics.files.total_lines_added'); removed=$(echo \"$input\" | jq -r '.metrics.files.total_lines_removed'); echo \"+$added/-$removed lines\""
    }
  }
}

Вывод: +120/-30 lines

Живые часы и ветка git

Используйте refreshInterval, когда строка статуса отображает данные, которые меняются без события агента (например, часы, время работы или счётчики rate-limit):


{
  "ui": {
    "statusLine": {
      "type": "command",
      "command": "input=$(cat); branch=$(echo \"$input\" | jq -r '.git.branch // \"no-git\"'); echo \"$(date +%H:%M:%S)  ($branch)\"",
      "refreshInterval": 1
    }
  }
}

Вывод (обновляется каждую секунду): 14:32:07 (main)

Файл скрипта для сложных команд

Для длинных команд сохраните файл скрипта по пути ~/.qwen/statusline-command.sh:


#!/bin/bash
input=$(cat)
model=$(echo "$input" | jq -r '.model.display_name')
pct=$(echo "$input" | jq -r '.context_window.used_percentage')
branch=$(echo "$input" | jq -r '.git.branch // empty')
added=$(echo "$input" | jq -r '.metrics.files.total_lines_added')
removed=$(echo "$input" | jq -r '.metrics.files.total_lines_removed')
 
parts=()
[ -n "$model" ] && parts+=("$model")
[ -n "$branch" ] && parts+=("($branch)")
[ "$pct" != "0" ] 2>/dev/null && parts+=("ctx:${pct}%")
([ "$added" -gt 0 ] || [ "$removed" -gt 0 ]) 2>/dev/null && parts+=("+${added}/-${removed}")
 
echo "${parts[*]}"

Затем укажите его в настройках:


{
  "ui": {
    "statusLine": {
      "type": "command",
      "command": "bash ~/.qwen/statusline-command.sh"
    }
  }
}

Поведение

Триггеры обновления: Строка статуса обновляется при смене модели, отправке нового сообщения (изменение количества токенов), переключении режима vim, смене ветки git, завершении вызовов инструментов или изменениях файлов. Обновления имеют задержку (debounce) 300 мс. Установите refreshInterval (в секундах), чтобы дополнительно запускать команду по таймеру — полезно для данных, меняющихся без события агента (часы, лимиты запросов, статус сборки).
Таймаут: Команды, выполняющиеся дольше 5 секунд, принудительно завершаются. При ошибке строка статуса очищается.
Вывод: Поддерживается многострочный вывод (до 2 строк; лишние строки игнорируются). Каждая строка отображается как отдельная строка с приглушёнными цветами в левой части нижней панели. Строки, превышающие доступную ширину, обрезаются.
Горячая перезагрузка: Изменения ui.statusLine в настройках применяются мгновенно — перезапуск не требуется.
Shell: Команды выполняются через /bin/sh на macOS/Linux. В Windows по умолчанию используется cmd.exe — оборачивайте POSIX-команды в bash -c "..." или указывайте путь к bash-скрипту (например, bash ~/.qwen/statusline-command.sh).
Удаление: Удалите ключ ui.statusLine из настроек, чтобы отключить функцию. Вернётся подсказка ”? for shortcuts”.

Устранение неполадок

Проблема	Причина	Решение
Строка статуса не отображается	Конфигурация по неверному пути	Должна находиться в `ui.statusLine`, а не в `statusLine` на корневом уровне
Пустой вывод	Команда завершается с ошибкой без вывода	Проверьте вручную: `echo '{"session_id":"test","version":"0.14.1","model":{"display_name":"test"},"context_window":{"context_window_size":0,"used_percentage":0,"remaining_percentage":100,"current_usage":0,"total_input_tokens":0,"total_output_tokens":0},"workspace":{"current_dir":"/tmp"},"metrics":{"models":{},"files":{"total_lines_added":0,"total_lines_removed":0}}}' \| sh -c 'your_command'`
Неактуальные данные	Не сработал триггер	Отправьте сообщение или переключите модель для запуска обновления — либо установите `refreshInterval`, чтобы запускать команду по таймеру
Команда выполняется слишком долго	Сложный скрипт	Оптимизируйте скрипт или перенесите тяжёлые вычисления в фоновый кэш