Troubleshooting

The app will not connect to the server

1. Check that the server is running (it prints listening on ... on startup)
2. Check that Server in Settings matches the address the server printed
3. Check that Token matches the string the server printed
4. When connecting from another machine, check that the server was started with a listening address such as --bind 0.0.0.0:8787

To see where b7 would connect, run b7 server status.

The terminal display is scrambled, or keys do not show up

Put the renderer in Settings back to xterm. The sessions stay on the server, so switching does not lose any work.

The experimental Grid renderer has open problems: keys that do not reach the screen, and Codex borders that do not appear.

Japanese input is sometimes unstable

The problem where input stopped after confirming 。 or 、 in the terminal is fixed. The general instability of Japanese input, however (characters dropped, conversion scrambled), is not understood and is still under investigation. If you can reproduce it, telling us what you were doing at the time helps.

With Codex, the terminal and the chat do not share a conversation

Codex cannot have one conversation open in two places at once, so the Codex chat holds a separate conversation from the terminal. This is by design. With Claude Code you can move between the terminal and the chat in one conversation.

A session disappeared

On startup, the server stands back up the sessions that were running before. It does not when it is started with --no-restore. The record of the sessions stays in a file on the server.

A phone will not connect

From an iPhone or iPad, even on the same network, the server has to listen on a different address (--bind 0.0.0.0:8787). To use it from outside, set up a tunnel such as Tailscale and put that host name in the settings.

Limits we know about

• Only the macOS (Apple Silicon) build is distributed. The iOS app is not out yet
• The Windows and Linux apps are untested. They are built to run, but we have no record of trying them
• Android is untested. It is part of the project
• There are reports that the app freezes when the window is made narrow. We have not reproduced it locally and are still investigating

A record of what went wrong is useful to development. Tell us in a form where the steps to reproduce it are clear.