devctl
One terminal for your local stack.
Start services, follow logs, trace requests, and inject cloud auth — from a keyboard-first TUI, the CLI, or an AI agent over MCP.
Potencialize seu agente
O comando do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
npx -y @amr-m-abdelgawad/[email protected]O Claude Code não tem link de instalação para um comando local. Copie o comando abaixo e execute-o em um terminal.
claude mcp add amr-m-abdelgawad-devctl -- npx -y @amr-m-abdelgawad/devctl@0.28.2Execute em um terminal.
{ "mcpServers": { "amr-m-abdelgawad-devctl": { "command": "npx", "args": [ "-y", "@amr-m-abdelgawad/[email protected]" ] } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirA multi-service repo usually means five terminals, a forgotten .env, and a proxy nobody remembers how to start. devctl reads .devctl/ and runs the whole environment as one session — and nothing in the app knows your services by name. You add YAML, not code.
What sets it apart:
npm, uv, python start as native host processes — fast reloads, a debugger you can attach directly, no Dockerfile — with Docker/Podman services opt-in when a dependency needs them.Google Cloud is optional. The demo platform starts locally without it and includes one opt-in route for testing service-account impersonation and IAP token minting.
Node.js 18 or later. The npm package installs its own Bun runtime; no gcloud is needed for the local demo.
git clone https://github.com/amr-m-abdelgawad/devctl.git
cd devctl/examples/demo-platform
npx @amr-m-abdelgawad/devctl@latest
In the TUI: enter starts a profile · n / x start or stop a row · l logs · ? help · q quit.
Profiles: minimal · backend · full (includes the React console on localhost:18003) · data (opt-in Docker/PostgreSQL).
Node.js is the only prerequisite — devctl bundles an official Bun runtime inside its npm package. For regular use, install it globally:
npm install --global @amr-m-abdelgawad/devctl
devctl version
Or run it without installing:
npx @amr-m-abdelgawad/devctl@latest
Unsigned standalone binaries and the repository's Homebrew formula remain available as alternative installation paths. Verify their published SHA-256 checksums; Apple and Microsoft do not identify those optional binaries as a verified publisher. Source installation still requires Bun. See Installation.
gcloud is needed only if a service or route uses user identity, impersonation, or IAP.
cd your-repo
devctl setup
devctl doctor
devctl
setup writes .devctl/config.yaml (or use the TUI setup screen).doctor names what is missing — ports, tools, ADC, container runtimes.enter starts the first profile (alphabetically).devctl start --profile backend then devctl attach. The daemon already outlives start; --detach is deprecated and does nothing.TUI prefs live in ~/.devctl/tui.json or DEVCTL_TUI_CONFIG. Built on OpenTUI.
flowchart LR
TUI --> Supervisor
CLI --> Supervisor
MCP["MCP · 127.0.0.1"] --> Supervisor
Web["Web · 127.0.0.1"] --> Supervisor
Supervisor --> Runtime["Host processes + containers"]
Supervisor --> Proxy
Supervisor --> Logs["Logs + traces"]
The supervisor owns host processes, optional Docker/Podman containers, the proxy, the log and trace buffers, and ~/.devctl/state/<repo>/. The TUI is a client. Agents talk HTTP to the same process — a stdio child of the TUI would die on quit. MCP and the web console are off by default. See how it fits together.
The full documentation site is also published as a GitHub Wiki. Changing this repository (not YAML in some other repo): contributor internals.
127.0.0.1 only; MCP, OTLP, and the web console are off by default.See Security for the full model.
devctl is pre-1.0 and under active development. A large portion of the codebase is AI-generated ("vibe-coded") rather than hand-written, so treat it as a work in progress. Reaching v1.0.0 will mean the codebase has been personally reviewed, tested, and validated, and the project is considered stable for general use. The roadmap lists what comes first, and which features are still experimental: those may change without a deprecation period until someone outside the original stack relies on them. If devctl doesn't fit your stack, tell us where it broke.
Use at your own risk. devctl is provided as-is, without warranty. It starts the processes in your configuration, reads the environment and secrets you point it at, and can mint cloud tokens or decrypt a SOPS file on your machine. You are responsible for that configuration, those credentials, and the commands it runs. See Security and the MIT license.
Issues and contributions are welcome — see Contributing.
MIT © 2026 Amr MOUSA · Contributing · Security policy
{ "mcpServers": { "amr-m-abdelgawad-devctl": { "command": "npx", "args": [ "-y", "@amr-m-abdelgawad/[email protected]" ] } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
@amr M Abdelgawad/devctl roda localmente via stdio.
Última verificação: 2026-11-11. Local development orchestrator