master-agents-client 1.0.0

Thin client for the Master Agents service. Talks to a hosted server; bundles no orchestration logic, prompts, or agent specs.

Master Agents — Client

Thin client for the Master Agents service.

This package gives you a CLI (agents) to chat with hosted agents, run one-shot prompts, and let those agents execute file/git/bash tools on your machine under explicit path allowlists.

The client ships no orchestration logic, no prompts, and no agent specs — those live on the service. You point this client at a service URL, log in, and start a conversation.

Install

pip install master-agents-client

Requires Python 3.11+.

First chat (60 seconds)

# 1. Save server URL + token (pasted at the prompt or via --token).
agents remote login --server https://agents-api.sim-os.ai

# 2. Start an interactive session.
agents remote chat

Inside the chat, type /help for the full command reference.

One-shot mode

agents remote run "summarise the README in ./my-project"

The chosen master agent decides which tools to call. File/edit/bash tools run on your machine inside the paths you allowlisted at login (see --writable-paths).

What runs where

	Where it runs
Chat REPL, slash commands	Your machine (this client)
File reads / writes / edits, bash, git	Your machine (this client)
Agent reasoning, model calls, retrieval	The service

The client never uploads your source files to the service — only the tool output text the agent asked for.

Configuration

Server URL + token live in ~/.master_agents/remote.yaml after login.

Override per-call with --config <path>. Env-var override: MASTER_AGENTS_REMOTE_CONFIG=/path/to/remote.yaml.

More

See USER_GUIDE.md for slash commands, troubleshooting, and environment variables.

License

MIT.