papermap, choose your workspace, ask questions, and watch streamed insight responses render without leaving your command line.
Papermap TUI
The terminal interface keeps analytics close to your development workflow.
Why use the TUI?
Keyboard-first analytics
Stay in the terminal, ask natural-language data questions, and move through workspaces, chats, models, and tools with shortcuts.
Streamed insight responses
See progress while Papermap works. Narrative answers, tables, tiles, charts, and reasoning traces render as the request completes.
Unified workspace flow
Launch into your unified workspace by default, then switch to any visible workspace with a searchable picker.
Terminal-native utilities
Run one-shot shell commands, copy transcript selections, browse conversation history, and switch LLM models in place.
Typical workflow
1
Install the CLI
Install
papermap with Homebrew, the install script, go install, or a source build. See Install the TUI.2
Sign in once
Run
papermap auth login. The default flow opens Papermap in your browser and returns a short-lived CLI code to your local terminal callback.3
Launch the TUI
Run
papermap. If your session is valid, Papermap opens directly into the chat workspace.4
Ask questions and navigate
Submit prompts with
Enter, use / for the command palette, Ctrl+W to switch workspaces, and Ctrl+P to reopen prior conversations.What the TUI can do
Ask data questions
Send prompts from the chat input and receive streamed Papermap answers in your terminal.
Review charts and tables
Papermap renders structured responses as readable terminal tables, tiles, and chart summaries.
Browse conversation history
Open prior chats for the active dashboard, page through history, and load the conversation you need.
Create database workspaces
Create Postgres, MySQL, MongoDB, and Supabase workspaces from interactive CLI forms.
The TUI is intentionally focused on terminal workflows: login, workspace selection, conversations, streamed insights, model selection, and shell mode. Use the Papermap web app for broader workspace administration, OAuth integrations, CSV or Sheets uploads, billing, and visual dashboard editing.
Next steps
Install the TUI
Choose the install path that matches your machine and launch
papermap.Authenticate
Learn browser login, password fallback, credential storage, and logout behavior.
Navigate the TUI
Master shortcuts, command palette, streaming, conversations, model switching, and shell mode.
Configure the TUI
Set API URLs, frontend URLs, default thinking traces, selected model, and Windows shell behavior.