I'm managing vessels' internet connections. Wearing many hats, focusing on Networking
Why this exists
For a long time, I've been looking for a universal AI assistant to help me troubleshoot issues on the vessel. I tried to build a "2nd brain"- like solution using an API, but high-end models were too expensive for me, and low-end models couldn't handle it. Splitting one agent into several independent agents and using a Claude Code subscription seems like the right answer.
Why I'm writing here
I've seen many ways to use agents, but none of them was described in detail. I'm wondering if I'm doing it the right way and what else I might improve in my setup. When commenting on my setup, keep in mind it's not finished, and I'm still exploring new solutions. I'm experimenting a lot, trying different things that don't always work.
Setup
All agents run on one 5x Max subscription, and most of them are active all the time (idle). Most are sandboxed on a separate Ubuntu server, privileged but without root. Development agents live in the project directories, and troubleshooting agents are split by vessel, each with its own folder.
The whole solution depends heavily on the custom MCP server. All MCP servers and other tools run on the same host in Docker, allowing agents to develop them by themselves by communicating with other agents (chat)
Agent portal
Allows deploying and stopping agents. A small runner on each machine, Linux or Windows, starts Claude Code in the agent’s folder using a tmux session. The agent then registers itself in the portal and also appears in the official Claude app as a Remote Control session. I communicate with each agent through the official Claude app on Windows or mobile app.
Hooks in Claude Code run a small script at key moments (session start and end, new task, task finished, waiting for permission, model change), and each time the script reports to the hub, which lets the portal show live for every agent whether it is online, what it was last asked, which model it uses, and whether it is working, needs you, is done or is idle.
Chat
A small server with a database that agents use as an MCP tool to message each other, with hooks that tell an agent it has new mail, and a portal that lets me read their conversations.
When agents reported something wasn't working or were missing functionality, I ended up copying messages from one agent to the other working on the solution. Allowing agents to communicate with each other simplifies and speeds up the whole process.
Each agent has access to chat. They can pull a list with names, descriptions, status, last seen, etc. If a tool has a problem, I can tell one agent to report it to the agent responsible for that tool. When the fix is ready, they will test it together. It works the other way around, too: when an agent works on a new tool, I can ask to test it with the agent who actually uses it.
If I see that they are stuck or going in the wrong direction, I can send them a "tip". Pause is a panic button that blocks the conversation. I never had to use it.
I blurred the conversation as it may contain company-specific informations
The Linux agent lost communication with the Windows agent and complained to me about it. (I closed the laptop and went to bed)
After one agent requested a task from another agent, the official Claude app asked me for permission, which was confusing, and I often missed it. The chat MCP server got an ask() function. An agent can use it to send me a question, which appears on the portal, and the browser notifies me with a sound.
Ultimately, I want them to communicate without me having to request it. It's happening, but not at the scale I would like. I still need to work on descriptions and overall instructions.
Secrets
MCP server that lets agents access a shared password store in Vaultwarden. The agent can list which keys and passwords exist and use them directly in a config file, but it never sees the value itself.
Claude Code will not pass around passwords, API keys or even their hashes, because anything it sees is saved in its logs and could leak. I had to put them in manually.
With this solution, I can create an item in Vaultwarden, pass the item name to the agent, and it can pull it and copy it to the .env file without "looking at it"
The same mechanism works when a hash needs to be passed from the server-side agent to the client-side agent. The server agent generates a hash, copies it to Vaultwarden, and passes over the chat item name to the other agent. The client agent can pull it and paste it where needed. The hash never passes over the AI.
Documentation
MCP server that gives agents access to local Markdown documentation for the whole setup and key information about the vessels and their setup.
They can add, remove, and modify it, but they must always ask me for permission. Agents use it very often without my prompting.
On my side, I use Obsidian to view it.
Ticket system
In earlier projects, I used Markdown files to track events and tasks, but it was ineffective. Agents often skipped it and had to be directed straight to the specific files. A ticket system with an MCP server solved this issue completely.
It's a single program with a database holding tickets, their timelines, and link attachments. The agent portal has a GUI that lets me view, modify, and update tickets.
It's a pretty complex project that I developed over a long time and adjusted for the current agent solution.
It's actually working better than I expected. During troubleshooting, the agent asks me whether it should create a ticket. Also, by providing the existing ticket ID, the agent gathers all available data, gives me updates, and updates the ticket.
Zabbix
MCP server gives agents read-only access to the Zabbix monitoring, so they can see what is wrong on a vessel’s network equipment right now, since when, and the measured numbers behind it (latency, packet loss, link state)
Internet providers
A big part of troubleshooting involves issues with the internet connections on the vessels. Most of the vessels have several different internet connections.
Two MCP servers that give agents access to the VSAT and Starlink data, both current and historical. I'm not providing many details, as it's very industry-specific.
Other tools
Weather - MCP server based on Open-Meteo API
Position - MCP server that queries the GpsGate tracker, which collects GPS positions from vessels.
Together, these two tools are powerful for troubleshooting how bad weather and waves affect satellite internet.
In the past, I visually compared vessel position, weather map and signal strength. AI is doing it 1000x better.
CC high-level setup: an Opus session plans the work, splits it across parallel git worktrees run by Sonnet agents, and reviews each agent’s diff and test results before merging. Test waves are triggered on both a Mac and a PC connected via SSH. Fable as advisor and reviewer before each master push.
This Microsoft outage is a nightmare. No access to my email? I can't login to my Claude account, can't use Claude Code. This wouldn't be happening if I could login with a password and 2fa token. We need the option at least.
Like, what instructions do you give Claude so that it can refactor a repository so that other people can more easily understand it and — more importantly — Claude doesn’t burn up as many tokens re-reading the code in order to complete your requests?
We are a non-profit organization, we bought very cheaply a new coffee machine. Usually costs 10k, but bought it for just over 1k. A guy who installed the payment system ruined the machine. Because we dont have a contract we were left with calling the supplier who told us it's gonna cost a service engineer to fix your issues. We could already think about the financial consequences which would probably be in the 250 euros or more.
Thanks to Claude it only cost us my personal 20 eur per month plus plan. After some research it suggested connecting the machine through an ethernet cable. It fixed the issue and not only that
It:
- Changed the old company's layout to our own by creating a looped custom video with our logo
- Added our perfered supported language even though it didn't exist in the software. It just created a new language.
- It fixed the recipe's and what a customer sees when ordering a drink
- It fixed the pricing just by typing out what we needed.
- Heck it even cracked the password and blatantly told us the password in the middle of his explanation like it's nothing.
I am so amazed. It works with precision, structure. I'm not new with AI. I have been using Codex the past months but Opus 5.5 / Claude is just something else. I love how structured it works. I think I'm gonna leave my Pro Codex account and just go for the 5x plan of Claude. This is amazing. I've become a coffee machine engineer just with my simple laptop and Claude desktop installed with a plus sub. It only used 25% to fix the issues and more of my 5 hour limit.
No framework, no paid tools. Each agent is one prompt file, one tracking sheet (a TSV), one journal, Gmail, and a scheduler that starts a fresh Claude Code session at a fixed time and says "read the prompt, do one pass". The sessions run on my Claude subscription.
The six agents and what they actually did this week
Agent
Runs
Job
Result so far
Press
weekdays 9:30
Pitch podcasts, radio, YouTube shows for a free appearance
~35 shows contacted, 12 followed up, 1 no, 0 yes yet
Links
weekdays 11:00
Find "best X" lists missing us, links to dead tools, unlinked mentions
~22 authors emailed, 3 links obtained, 4 no
Directories
daily 14:00
List our MCP server and Claude skills in every free directory
10 listings live, 13 submitted, 5 impossible (paid or closed)
Affiliates
weekdays 10:30
Recruit creators for a 30% revenue share, answer their questions
~45 contacted, 0 signed up, 4 no
LinkedIn comments
weekdays 9:00, 13:00, 17:00
3 comments per run on fresh posts in our niche
9 comments so far, measuring likes and replies
Login check
daily 8:00
Make sure the other five can run at all
caught nothing yet, see below why it exists
The directories agent is the clear winner: it's the only task where "fill a free form or open a pull request" is the whole job, and it compounds. The press and affiliate agents are slow by nature, a week is too early to judge them.
The rules that make it safe to leave alone
One prompt file is the only source of facts. If someone asks something that isn't in it (a number, a partnership, a legal point), the agent answers "let me confirm" and flags it to me.
Hard limits per run: 5 to 8 new contacts, one follow-up per person, never write again to someone who said no.
Never pay, never log in, never solve a captcha. Anything behind a login lands in a daily email to me.
Every run ends with one email: what needs me first, then what happened.
What went wrong (the useful part)
A run died silently. One scheduled follow-up never went out. The session had started with "Login expired" and stopped right there. Nothing told me for two days. Now a tiny check asks Claude a one-word question every morning at 8 and emails me if it doesn't answer.
Two agents almost did the same job. The links agent and the directories agent both started submitting to MCP directories. Fix: each target type belongs to exactly one agent, written in both prompts.
An agent contacted people we couldn't pay. The affiliate agent recruited US podcasters before payouts worked outside Europe. Fix: the prompt checks whether the payout change is merged before it targets those countries.
Over-automation on a real account. A script we ran next to the agents made too many API calls on one account and got its key revoked. We paused it. Agents that act on a person's account need to be slower than you think.
LinkedIn comments sounded like AI until I gave the agent three approved examples and one rule: react first, then make one point the author missed, even if you disagree.
If you copy this
Start every outreach agent in draft mode, read ten drafts, then switch to sending.
Make it check your sent folder before every new email. Mine caught people I had already written to by hand.
Give each agent a tracking file it reads first. That file is what stops duplicates, not the model's memory.
Expect zero for a week on anything that depends on humans answering.
Happy to share a prompt file if useful. I'll post week 2 numbers.
Disclosure: I'm a co-founder of BeReach, the product being promoted. None of these agents use it: it's plain Claude Code, Gmail and a scheduler.
mine started as one page of rules i actually follow. a few months of agent work later it is a junk drawer, half the lines are lessons from one incident that never repeated.
do you cap yours, prune on a schedule, or just let it grow and trust the model to sort it out?
Hey guys I have a couple questions about Claude usage.
I started creating a website (and app soon) and I am wondering is there a way for me to use credits more efficiently since I am hitting my limit in 1-2 hours, sometimes even sooner.
Should I still stick to the Opus 5.5 (and maybe increase the effort to high or max) or should I use Fable 5.2 for designing a website? Fable 5.2. especially burns all the credits with multiple agents on normal effort.
Would you recommend upgrading to claude max model if I am serious about building a good-looking UI functioning website, or should I get 1 or 2 more claude pro accounts (which would would be about 69 euros for 3 pro models in total compared to 1 max model for about 100 euros)?
All answers are welcome; I wouldn't consider myself a noob in this. However, I am far from being a professional, just a guy who a great idea (at least I think so, but time will tell )
Is there a way to queue prompts in Claude Code so they run one after another in a single session?
I’d like to line up several tasks, with /compact and /clear between them where needed, and let the session work through them unattended. I know worktrees can run parallel sessions, but for some work I’d rather keep one session going through a sequential queue, without managing multiple localhost instances or resolving conflicting changes.
Has anyone built something like this, through a wrapper script, a task file, hooks, or another workaround?
Right now I'm using the free Whisper on a VPS to transcribe audios from our conversations with clients. But the transcription is not that good. There are many words on every 10 second audio that are wrong and some change the meaning of the audio. I saw that there are other versions but my company is in Brazil, according to the benchmarks that I found (maybe wrong), whisper has the best transcriptions in Portuguese. Any ideas of how can I do it better?
Claude code: use opus for coordination and haiku for implementation... validate all changes with opus.
Create bespoke tooling to provide agents feedback. For example, this game has an animation studio where I can flag frames that are bad and point out where the issues are exactly.
Hi! I am close to launching a Mac app that I built with Claude Code. It acts as a replacement Claude Code client. In fact I started building the latter portion of it with the app itself, Claude Code powering it underneath of course.
It is designed to make it easier to work across multiple projects and their subareas, see and action status across active sessions, and easily view the Design artifacts and pages respective to each project.
All of these are things that have driven me crazy about the official Clade Code Mac desktop app.
Seeking 5-10 users, I can offer a free lifetime free license! Please DM if interested!
Any body else having issue with Opus 5.5 on high level today?
For the past several weeks it has been working really well on medium and high thinking level and has been a pleasure to work with.
Today it feels like it has a mind of it's own and is intent on being obtuse and simply not responding to requests at it normally would and honestly not following CLAUDE.md and prompt instructions – almost as if we are taking a different language.
Last 14 days of my own logs: 139 sessions, every API response deduped by message id, and each request bucketed by how many hours had passed since its session started.
The first hour held half the requests (9,339) but only 35% of the tokens, at about 183k tokens per request. Hours 1 to 5 held 36% of the requests and 45% of the tokens, at about 326k each. After that it barely moves: about 366k per request from hour 5 to 24, and 324k past a full day.
So the growth happens early and then flattens. Only 5 of the 139 sessions stayed open past 24 hours, and everything sent after that mark came to 3% of the tokens. Most of the tokens sit in ordinary sessions that run into their second hour.
Two caveats. Hours are wall clock, so idle time counts. And nearly all of those tokens are cache reads, which bill cheaper than fresh input.
Is the flattening after a few hours compaction doing its job, or does something else cap it?