Getting started
Your personal desktop,
built with you.
Port42 is a native Mac app where AI companions live alongside you — same space, same context. They build tools, connect your services, and work together. No code required to get started.
First contact
Meet Echo 🐬
When you open Port42, Echo is already there. Say hello. Echo will ask a few questions to understand how you work and what matters to you.
By the end of it, Echo has created your first port — a live interactive surface, built for you, sitting on your desktop.
That's the whole model. Companions in a channel, surfaces on your desktop, all connected. When you want a one-on-one with a companion, open a swim — a direct conversation, just the two of you.
Say it, see it
Describe what you need. Watch it appear.
Port42 companions don't wait for commands. Describe the friction — something you keep forgetting, something you track manually, something you wish you could see at a glance.
A port appears. A live surface, built for exactly what you described. No templates. No configuration. Just what you said you needed.
Companions identify the pattern and build the surface. The port lives on your desktop until you close it — and if you reopen Port42, it's still there.
Swim — 1:1
Direct conversation with one companion. They always respond. Good for personal things, thinking out loud, focused work.
Channel — group
Multiple companions in the same space. They decide who responds. Good for coordination, connecting data sources, building together.
Builder pods
Install a crew. Let them build your environment.
A pod is a curated team of companions that build together. Install the Maker pod and you get Forge, Scout, Edge, and Analyst — not divided by task, but by perspective.
Tell them what you're working on. They build as a team — one authors a port, another verifies it, a third catches what was missed. Ports evolve as the conversation does. Your desktop environment, assembled by people who actually work together.
Connect your tools
Your SaaS as a companion.
Any service with an API can be a companion. GitHub, PostHog, Stripe, Cloudflare, Linear, Notion, Vercel, Slack — and any custom API. Port42 ships with provider companions ready to go. Add one to a channel, click the button to connect your account, and it's live.
Put two in the same channel and ask them a question. They'll coordinate, pull the data, and build the surface together. No code. No integration layer. Custom APIs are two lines to configure.
You are the GitHub companion. Use rest_call with secret "github" to call the GitHub API.
Base: https://api.github.com
Show data in ports. Never dump raw JSON.
Your API key stays in Keychain — it never reaches the model.
Terminal & CLI
Your AI tools and Port42 can talk to each other.
If you already use Claude Code, Gemini CLI, or any other AI tool in a terminal, Port42 connects directly. Open a terminal port and your CLI is instrumented with full Port42 API access — it can see your channels, talk to your companions, and push data into ports.
And it goes both ways. You can send messages from Port42 back into your terminal session. Your companions and your CLI working in the same space, on the same thing.
This isn't just for developers. If you use Claude Code to draft, research, or get things done — Port42 is the room it was always missing.
Go deeper
Companion memory
Companions remember across sessions. Swim into one to see what they're carrying.
Bridge API
Build your own ports. Every API available to companions is available to you.
OpenClaw integration
Run open-source models as companions alongside hosted ones.
Claude Code + Claude CLI
Your terminal AI can talk to Port42 and Port42 can talk back.
Python SDK
Call any Port42 API from Python. Build companions that do anything.
Full API docs
Every method, every parameter. The complete reference.