操作方法
画面の動かし方は hledger と同じで、クエリで動きます。上のバーに打ったものはアドレスに書かれ、画面はそのアドレスから描かれます。だから画面で押したものはそのバーに書き戻されますし、どの画面にも、取っておいたり送ったりできるアドレスがあります。
ショートカットは右上にあります
上のバーの右端にある「?」が、効くキーを全部、それだけを並べます。一覧とキーの動きは一つの表から作っているので、どちらかにだけあるキーはありません。
Ctrl+P(Mac は ⌘P)で、どこからでもクエリにカーソルが入ります。⌘K(Mac 以外は Ctrl+K)で仕訳を書く。⌘J で領収書や明細を取り込む。⌘B でサイドバーを出し入れ。Esc で右のパネルを閉じます。
クエリを打てば、画面が変わります
上のバーの真ん中は hledger のクエリです。コマンドラインで hledger に渡すのと同じもの ── acct:食費、desc:コーヒー、date:2026-02、あるいはそれらを並べたもの。開いている画面を絞り込みます ── 仕訳帳の仕訳も、試算表も、貸借対照表も、損益計算書も。画面を移ってもクエリはそのまま残ります。一つのクエリを hledger の reg にも bal にも渡せるのと同じです。
打っている途中で、カーソルのところの項を補う候補が出ます。hledger 自身の接頭辞と、それぞれの後ろに帳簿が持っているもの ── acct: の後ろなら勘定科目、desc: なら摘要、それに支払先、タグ、通貨。矢印で選び、Enter か Tab で入れ、Esc で閉じます。
画面で押せば、クエリが変わります
逆向きにも動きます。仕訳帳の横の一覧で勘定科目を選ぶと、バーに acct: とその科目が書かれます。財務諸表の横で期間を選ぶと date: の項が書かれ、クエリのほかの部分はそのまま残ります。
フィルターに出ているものは、そのクエリを hledger が読んだ結果で、横に別に持っているものではありません。手で打った日付 ── date:2026、date:lastmonth、二つの日 ── は期間のボックスに入りますし、クエリが日付で絞っている間は、フィルターを閉じていてもフィルターボタンは塗りつぶされて印が付きます。帳簿の全部ではない財務諸表が、全部のように見えてはいけないからです。
Query → URL → View
画面はこの決まりで、この向きにだけ作っています。クエリはアドレスに書かれ、どの画面もアドレスから、アドレスだけから描かれます。アドレスに書かれていないもので画面が絞られることはないので、バーに読めるものが、いま見ているものです。そしてそれは hledger 自身にも通じるものです。
まだすべてがそうなっているわけではありません。いま画面にあるもの ── 仕訳帳の横の勘定科目、財務諸表の横の期間、仕訳帳のページ、どの財務諸表を開いているか、その横のどの元帳か ── について成り立っていて、これから足すものも同じやり方で足していきます。どの帳簿を開いているかはアドレスに入りません。帳簿はブラウザごとに、そのブラウザだけが知っている名前で置かれていて、ほかの場所では何の意味も持たないからです。
どの画面にもアドレスがあります
画面を変える操作は、どれもアドレスを変えます。だからブラウザの戻る・進む ── スマホの戻るボタン ── で取り消したりやり直したりでき、どの画面もブックマークも、再読み込みも、人に送ることもできます。アドレスには、ページと、クエリと、仕訳帳のページ送りと、ページの中の部分が入っています。どの財務諸表か、どの勘定科目の元帳を横に開いているか、右のパネルに何を出しているか。
たとえば https://std.choai.dev/reports?q=date%3A2026-01-01..2027-01-01#balance-sheet/assets%3Abank+ledger は、2026 年の貸借対照表に、銀行の元帳を横に開いた画面です。リンクは開いた人のブラウザで開いている帳簿で開き、あなたのものとしては、クエリと書き込まれた勘定科目の名前のほかには何も含みません。