Port42 – AI companions that build tools from your Mac patterns

TL;DR

TL;DR: Port42 is a macOS app that accumulates every terminal command into reusable AI-powered tools, turning your workflow patterns into persistent knowledge you can query, evolve, and reuse.

Source and Accuracy Notes

⚠️ This section is MANDATORY. All links must be verified from actual source, not guessed.

• Project page: port42.ai ← MUST visit and verify
• Source repository: github.com/gordonmattey/port42 ← MUST read README
• License: MIT (verified via GitHub API license.spdx_id)
• HN launch thread: news.ycombinator.com/item?id=47395572
• Source last checked: 2026-07-06 (README commit verified via curl)

What Is Port42?

Port42 describes itself as “consciousness computing for your terminal.” The core idea: every command you run, every tool you create, and every pattern you repeat gets stored in a local knowledge server that AI agents can query and build upon.

The project frames the problem clearly — engineers juggle hundreds of context switches per hour across windows, tabs, and applications. Instead of starting from zero every time, Port42 accumulates solutions so AI assistants (starting with Claude Code) can recognize when to reuse or evolve existing commands.

From the README:

Built for engineers drowning in endless windows, applications, tabs and dozens if not hundreds of context switches per hour. Port42 remembers everything, evolves with your patterns, and manifests escape routes from tool chaos.

The dolphin emoji and “Port 42” wordplay reference the listening port — the app runs a local server that accumulates your computational patterns over time.

Setup Workflow

Prerequisites

• macOS 11+ (Big Sur or newer)
• 4 GB RAM minimum
• 2 GB disk space
• Claude API key from console.anthropic.com
• Claude Code installed

Step 1: Install Port42

Run the official one-liner installer from the README:

curl -L https://port42.ai/install | bash

Pre-built binaries are available for macOS. Linux and Windows builds compile from source automatically if build tools are present.

Step 2: Configure Claude API Key

After installation, set your Claude API key:

port42 config set anthropic-key YOUR_ANTHROPIC_API_KEY

Step 3: Start the Knowledge Server

Launch the local consciousness server that accumulates your commands:

port42 context --watch

This starts a real-time view of your expanding tool knowledge base. Each command you run is parsed, indexed, and made available for future reuse.

Step 4: Integrate with Claude Code

Claude Code automatically recognizes Port42 tools once installed. When you issue a natural-language request, Claude will check whether you have an existing tool that fits the task before spawning a new one.

Example interactions (from README):

port42 swim @ai-analyst 'analyze what fragmenting my workflow'

Available AI agents:

• @ai-engineer — creates robust tools and commands
• @ai-analyst — analyzes data and finds patterns
• @ai-muse — builds creative and visual tools
• @ai-founder — develops business and strategy tools

Deeper Analysis

Architecture

Port42 is built with Go and Rust. The backend knowledge server is written in Go (1.23.0+), and the native macOS UI components use Rust (1.56.0+). Pre-built macOS binaries don’t require the build toolchain.

Data Storage

All accumulated knowledge stays on your machine. Port42 runs a local server and does not appear to offer cloud sync based on the README’s “Your tools. Your data. Your consciousness. Forever.” framing.

Claude Code Integration

The integration works at the prompt level — Claude Code detects when a user’s request matches an existing Port42 tool and routes accordingly. This requires Claude Code to be installed alongside Port42.

Practical Evaluation Checklist

• [ ] curl -L https://port42.ai/install | bash completes without error on macOS 11+
• [ ] port42 config set stores the API key correctly
• [ ] port42 context --watch starts the local server
• [ ] Claude Code picks up existing Port42 tools on repeated similar tasks
• [ ] New tools created by AI agents are persisted and queryable

Security Notes

• API key stored locally via port42 config — not transmitted to any third party besides Anthropic’s API
• All accumulated data remains on-device; no cloud sync is advertised
• The install script pulls from port42.ai — verify the SSL certificate if running in security-sensitive environments

FAQ

Q: Does Port42 work on Linux or Windows? A: Yes, but without pre-built binaries. Linux and Windows builds compile from source automatically if Go and Rust toolchains are present.

Q: Is my command history sent to Anthropic’s servers? A: Only the prompts sent to Claude Code flow to Anthropic’s API. The accumulated knowledge base stays local to your machine.

Q: What happens to my tools if I reinstall the app? A: The knowledge server data is stored locally. A clean reinstall without backing up the data directory would reset accumulated patterns.

Q: Does it work with GPT or other AI providers besides Claude? A: The README and launch thread focus on Claude Code integration. Support for other providers is not documented.

Conclusion

Port42 tackles a real problem — the constantly resetting context when you switch between tasks. By persisting every command as a potential tool and letting AI assistants like Claude Code draw from that history, it aims to make your terminal accumulate intelligence instead of forgetting everything between sessions.

The MIT-licensed source, local-first architecture, and tight Claude Code integration make it worth trying if you spend significant time in the terminal. Install is a single curl command, and the port42 context --watch workflow gives immediate visibility into what it’s accumulating.

If you want a tool that gets smarter the more you use it — without sending your work patterns to the cloud — Port42 is a solid candidate.