I don’t want to sit in front of the computer watching it work. I want to fire off a task, and continue my merry life eventually helping it along the way, . Walk in the forest, tinker with woodworking or draw with my kids.
The promise of agents is that they should continue working in the background. But that promise is not realized when you have to sit and wait until your Claude overlords demand more permissions from you.
So I wrote jackpoint to wrap the Claude sessions so that I can fire them off on the computer and continue them on mobile. Its using the Matrix protocol and I’m managing my sessions via Beeper.
Jackpoint is giving full terminal access to the Matrix account that it connects to. Matrix has double-ratchet end-to-end encryption, but you should still be careful.
TLDR: Install with `npm install -g jackpoint`. Repository is here, and here are the full docs:
Jackpoint
A bidirectional Matrix bridge for Claude Code. Get notifications on your phone when Claude needs input, and respond directly from Matrix.
Why?
When running long Claude Code sessions, you don’t want to babysit your terminal. Jackpoint sends you a Matrix DM when Claude:
Asks a question
Needs permission for a tool
Stops and waits for input
You can respond from your phone, and the message gets injected back into the terminal.
Requirements
Node.js 18+
tmux (for bidirectional communication)
A Matrix account (e.g., on matrix.org)
Claude Code CLI
Installation
npm install -g jackpoint
Setup
Run the setup wizard to configure your Matrix credentials:
Matrix username (for the bot account that runs Claude)
Matrix password (for the bot account)
Recipient user ID (your personal Matrix ID that receives notifications – usually yourself on mobile)
Note: The login credentials are for a bot account that will run Claude and send you notifications. This can be a separate Matrix account or your main account. The recipient user ID is where you want to receive the notifications (typically your main Matrix account that you check on your phone).
Credentials are stored in ~/.jackpoint/ (not in the repo).
Usage
Start Claude Code with Matrix integration:
# Must be inside tmux
jackpoint claude
With arguments:
jackpoint claude --model sonnet
jackpoint claude --resume
Matrix Commands
In your Matrix DM, you can use these commands:
Command
Description
/lines [n]
Show last n lines of terminal output (default: 30)
/help
Show available commands
Any other message is sent directly to Claude as input.
How It Works
Wrapper Pattern: jackpoint claude wraps Claude Code and injects hooks via --settings flag
IPC Socket: Hooks ping a Unix socket instead of doing Matrix I/O directly
Matrix Listener: Listens for incoming Matrix messages and injects them via tmux send-keys
Session Persistence: Matrix rooms persist by tmux pane (hostname:session:window.pane)
