Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

statusline

Deprecated: uji draws its own status line now. The views below still work for custom bars.

setup draws the default bar as uji’s status line: directory, model, reasoning effort, context use, tokens, cache hit rate and turns. Calling it again replaces the bar.

require("statusline").setup()

Segments

Each segment is an ito view that draws nothing while it has nothing to show.

ViewShows
statusline.Cwd()The session’s directory.
statusline.Model()The provider and model.
statusline.Effort()The reasoning effort, while reasoning is on.
statusline.Context()The context use, in the theme’s notice colour from 80%.
statusline.Tokens()The tokens spent.
statusline.Cache()The cache hit rate of the last request.
statusline.Turns()The number of your messages.
statusline.Logo()The uji logo while the session is empty. A screen shows it over the transcript with screen.transcript():overlay(statusline.Logo()).

statusline.Bar(children)

A one-row ito.HStack that puts a separator between neighbouring segments. A segment that draws nothing gets none, and neither does an ito.Spacer, so spacers split the bar into left, centre and right. separator in the props changes the text between segments, " · " by default.

statusline.Default is the bar setup adds.

local ito = require("ito")
local statusline = require("statusline")

local branch = ito.state("")
uji.job.start({
  cmd = { "git", "branch", "--show-current" },
  on_stdout = function(line)
    branch.value = line
  end,
})

local Branch = ito.view(function()
  return branch.value ~= "" and ito.Text(branch.value):foreground(ito.theme().colors.accent)
end)

uji.ui.status(statusline.Bar({ statusline.Cwd(), Branch(), ito.Spacer(), statusline.Context() }))

uji.ui.toolbar({
  ito.ToolbarItem(ito.ToolbarPlacement.keyboard, function()
    return statusline.Bar({ statusline.Model(), ito.Spacer(), statusline.Effort() })
  end),
})