special: the board, the agenda and the calendar in a workspace of their own

The board swapped out the tree, and the agenda and the calendar were
overlays over it, each with a key to open and a key to close. They are now
three tiles of one special workspace, as the desktop keeps its scratchpad:
the board on the left, the agenda over the calendar on the right.

S puts it up and away from anywhere. b, t and C go straight to their tile,
and put the workspace away when that tile already has focus. Alt-h/j/k/l
move the focus between the tiles, f gives the focused one the porthole,
and the tiles without focus keep their cursors, dimmed. A digit switches
space as everywhere, and the board follows; the board's head names every
space that has one. Enter on an agenda card goes to it on the board beside.
A space without a board says so in the board's tile instead of refusing.

The rail offers the three tiles as doors, so a phone, which shows one at a
time, can walk between them. The help, the README, the wiki and the
screenshots say how it works now.

docs/wiki/Boards-and-Agenda.md

@@ -1,11 +1,33 @@
 # Boards and the agenda
 
+## The special workspace
+
+The board, the agenda and the [calendar](Diary.md#the-calendar) share one
+workspace of their own, as the desktop's special workspace holds what is
+looked at in passing. `S` (or `:special`) puts it up and away again. It is
+three tiles: the board on the left, the agenda over the calendar on the right.
+
+![The special workspace](../images/board.png)
+
+| key | what it does |
+| --- | --- |
+| `S` | put the special workspace up, or away |
+| `b`, `t`, `C` | straight to the board, the agenda or the calendar; again on the one with focus puts the workspace away |
+| `Alt-h` / `Alt-j` / `Alt-k` / `Alt-l` | focus the tile that way |
+| `f` | the focused tile fills the screen; again or `Esc` to leave |
+| `1` … `9` | switch space, and the board with it |
+| `q`, `Esc` | back to the tree |
+
+The keys go to the tile with focus, which wears the light border; the other
+tiles keep their cursors, dimmed. Everything in it is read again each time it
+comes up.
+
 ## The board
 
 Every space except the diary has a board. `b`, the board button on the rail, or
-`:board` swaps the tree for it, and `q` swaps back.
-
-![The board of a space](../images/board.png)
+`:board` shows it in the special workspace, and `q` goes back to the tree. The
+head of the board names every space that has one, with the digit that goes
+there.
 
 A new board has three lists: `backlog`, `doing` and `done`. The lists mean
 something by where they stand, not by their names:
@@ -33,11 +55,11 @@ a week fold away until `z` shows them.
 | `z` | show done cards older than a week |
 | `F` | a letter over every card; type it to jump there |
 | `x`, `dd` | delete the card |
-| `q`, `Esc` | back to the tree |
+| `q`, `Esc` | put the special workspace away |
 
 ### Capturing a card
 
-`c` anywhere outside the board opens `:card ` on the command line. The card goes
+`c` anywhere outside the special workspace opens `:card ` on the command line. The card goes
 into the inbox of the space you are in, or of the first space with a board, and
 you stay where you were. From outside the browser, see [Capture](Capture.md).
 
@@ -86,7 +108,8 @@ does not make a second copy. The board and the agenda show the rule as
 
 ## The agenda
 
-`t` (or `:agenda`) gathers what needs you from every board at once.
+`t` (or `:agenda`) gathers what needs you from every board at once, in the
+special workspace beside the board.
 
 ![The agenda](../images/agenda.png)
 
@@ -99,13 +122,13 @@ does not make a second copy. The board and the agenda show the rule as
 | key | what it does |
 | --- | --- |
 | `j` / `k` | down / up, on into the diary entries |
-| `Enter` | to the card on its own board, or open the entry |
+| `Enter` | to the card on its own board, in the tile beside, or open the entry |
 | `Space` | finish the card where it stands |
 | `D` | due date |
 | `H` / `L` | to the list left / right on its board |
 | `:` | the command line with the agenda kept up, so `:repeat` acts on the card |
 | `T` | today's diary entry |
-| `t`, `q`, `Esc` | close |
+| `t`, `q`, `Esc` | put the special workspace away |
 
 The agenda opens by itself once a day when something is late or due. "Today"
 is the day in `WORKSPACE_TIMEZONE`, the same as for the mails, so a browser in

docs/wiki/Commands.md

@@ -42,12 +42,14 @@ arguments and `↑` / `↓` recall earlier lines.
 | `m / p` | pick nodes up, then drop them all into the folder you walk to |
 | `M` | pick up the whole folder — again puts it all back |
 | `Ctrl / Shift-click` | pick a row up · every row up to it — drag them onto a folder |
-| `t` | agenda — late, due this week, in hand, on every board |
+| `S` | the special workspace: the board, the agenda and the calendar side by side — again puts it away |
+| `Alt-h/j/k/l · f` | in the special workspace: to the board, the agenda or the calendar — f gives one the screen |
+| `t` | agenda — late, due this week, in hand, on every board — in the special workspace |
 | `T` | today's diary entry, started if there is none — from templates/day when the diary has one |
-| `C` | the diary by month: h/l a day, j/k a week, H/L a month, . today, Enter opens or starts the day |
+| `C` | the diary by month, in the special workspace: h/l a day, j/k a week, H/L a month, . today, Enter opens or starts the day |
 | `[d / ]d` | the diary entry before / after the one open, by date |
 | `Ctrl-P` | find anything, in every space — Enter goes to the result lit |
-| `b` | open this space's board |
+| `b` | this space's board, in the special workspace — 1 … 9 there shows another space's |
 | `c` | capture a card into this space's inbox, without leaving here |
 | `Esc · q` | close the document, and its tile when there are several |
 | `/` | full-text search, inside the current space and its text files — Tab or Ctrl-N/P walk the results, Enter opens one |
@@ -82,20 +84,20 @@ The first list is the inbox, the last list is done.
 | `F` | a letter over every card in view — type it to put the cursor there |
 | `r` | read the board again, for changes made elsewhere |
 | `x · dd` | delete the card (asks y/N) |
-| `q · Esc` | back to the tree |
+| `q · Esc` | put the special workspace away |
 
 ### In the agenda
 
 | key | what it does |
 | --- | --- |
 | `j / k` | down / up the cards, then what was written on this day in earlier years |
-| `Enter` | to the card, on its own board — or to the entry |
+| `Enter` | to the card, on its own board beside — or to the entry |
 | `Space` | done, where it stands |
 | `D` | due date: fri, tm, +3d … — :due on the line |
 | `:` | the line, with the agenda kept up — :repeat weekly acts on the card |
 | `H / L` | to the list left / right on its board |
 | `T` | today's diary entry |
-| `t · q · Esc` | close the agenda |
+| `t · q · Esc` | put the special workspace away |
 
 ## Commands
 
@@ -121,7 +123,8 @@ do: `:w!`, `:space! <name>`, `:import!`.
 
 | command | what it does |
 | --- | --- |
-| `:board` | show this space's board, or go back to the tree |
+| `:board` | this space's board, in the special workspace — again puts it away |
+| `:special` | the special workspace: the board, the agenda and the calendar side by side — S toggles it, Alt-h/j/k/l moves between them, 1 … 9 picks the board |
 | `:card, :c <title>` | add a card — on the board to the list under the cursor, elsewhere to this space's inbox |
 | `:card!` | add a card linked to the open document — Enter on it opens the document |
 | `:due <when\|->` | due date of the card — on the board, or highlighted in the agenda: today, tm, fri, +3d, +2w, 10-31, 2026-10-31 — - clears |

docs/wiki/Diary.md

@@ -13,7 +13,9 @@ an entry written after midnight on a trip still lands on the right day.
 
 ## The calendar
 
-`C` (or `:cal`) shows the diary a month at a time.
+`C` (or `:cal`) shows the diary a month at a time, in the
+[special workspace](Boards-and-Agenda.md#the-special-workspace) under the
+agenda.
 
 ![The diary by month](../images/calendar.png)
 
@@ -24,7 +26,7 @@ an entry written after midnight on a trip still lands on the right day.
 | `H` / `L` | a month back / forward |
 | `.` | today |
 | `Enter` | open the day's entry, or start one dated that day |
-| `C`, `Esc` | close |
+| `C`, `Esc` | put the special workspace away |
 
 A dot marks a day with an entry. A number says how many when there are more
 than one.

docs/wiki/Getting-Started.md

@@ -72,7 +72,8 @@ The rail of buttons on the right does the same as the keys, for a mouse.
    `h` comes back up.
 6. Press `c`, type `try the board`, and press `Enter`. That is a card in the
    inbox of this space's board. Press `b` to see the board, and `b` again to go
-   back.
+   back. It shares a special workspace with the agenda and the calendar: `S`
+   puts it up, and `Alt-h`/`Alt-l` move between them.
 7. Press `T`. That is today's diary entry, started for you.
 8. Press `?` for the list of every key and command. `h` / `l` walk its columns, `/` narrows it down, and `Esc` closes it.
 

docs/wiki/Guide.md

@@ -11,7 +11,9 @@ The keys are the desktop's. On a phone, every one of these has a button; see
 ## Morning: what needs you
 
 The first time you open the workspace each day, the **agenda** opens by itself
-when anything is late or due. Any other time, press `t`.
+when anything is late or due. Any other time, press `t`. It opens in the
+**special workspace**, beside the board and the calendar; `S` puts that up and
+away from anywhere, and `Alt-h`/`Alt-l` move between its tiles.
 
 ![The agenda](../images/agenda.png)
 
@@ -31,9 +33,9 @@ Walk it with `j` and `k`. On a card:
 - `Space` finishes it, where it stands;
 - `D` gives it a due date: `fri`, `tm`, `+3d`, `10-31`;
 - `H` and `L` move it to the list left or right on its board;
-- `Enter` goes to the card on its own board.
+- `Enter` goes to the card on its own board, in the tile beside.
 
-`Esc` or `t` closes the agenda. The bar keeps showing the `late` and `today`
+`Esc` or `t` puts the special workspace away. The bar keeps showing the `late` and `today`
 counts while either is above zero. More in [Boards and the agenda](Boards-and-Agenda.md).
 
 ## At work: spaces, documents and tiles
@@ -84,7 +86,8 @@ In a meeting someone asks you to renew a certificate. Press `c`, type
 `Renew the gateway certificate`, and `Enter`. The card is in this space's
 inbox, and you have not left the document you were reading.
 
-Press `b` to see the **board**.
+Press `b` to see the **board**, in the special workspace. A digit there
+shows the board of another space.
 
 ![The board](../images/board.png)