convez.ai
AgenteAutomaçãoAvançado
jaskier-os

PC Agent

jaskier-os/pc-agent

Agente PC que executa tarefas locais via linguagem natural com guardrails de segurança

Ver no GitHub
InicialPluginScore · de 0 a 100

Agente executado localmente que converte requisições em linguagem natural em comandos shell guardados, operações de arquivo e sessões Claude Code. Registra-se com o orquestrador via WebSocket e expõe ferramentas com controle de acesso (listas allow/deny, execução de shell, leitura/escrita de arquivos, busca com glob/grep).

Instalação

$npx convez-ai jaskier-os/pc-agent

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 1 semana
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Automação de tarefas de desenvolvimento local via comandos naturais
  • Execução controlada de scripts shell com listas de permissão/bloqueio
  • Integração de sessões de código Claude Code em ambiente local
  • Manipulação de arquivos (leitura, escrita, edição) através de requisições em linguagem natural

Veredito

Ferramenta robusta para automação local com ênfase em segurança. Ideal para equipes que precisam de execução controlada de tarefas no PC sem exposição de shell direto; requer configuração cuidadosa de guardrails e conhecimento técnico para deploy.

README

A tradução para o português deste README ainda está na fila.

pc-agent

Docs & wiki: github.com/jaskier-os/docs/wiki

A PC-side agent that turns natural-language requests into shell commands and runs them on the local host. It registers with the orchestrator over WebSocket and exposes guarded tools: shell execution (allow/deny listed), file read/write/edit, glob/grep, an LLM-backed explore tool, and long-running Claude Code "code task" sessions. It also runs a small HTTP server (health plus an /api/v1/tg-upload route that bounces files like test recordings to Telegram). Runs locally, not in the cluster.

Build / run

No compile step. Install deps and start:

npm install
cp .env.example .env   # then edit it
node src/index.js      # or: npm start, or: npm run dev (--watch)

./run.sh installs deps then starts. Tests:

npm test               # unit tests for the tool layer (no network)
npm run test:e2e       # against a running orchestrator

Docker (exposes port 10004 for health + tg-upload):

docker build -t pc-agent .
docker run --env-file .env -p 10004:10004 pc-agent

Configuration

Config lives in environment variables. .env.example is the source of truth - copy it to .env and edit; every var is documented inline.

Required: API_KEY, TELEGRAM_API_ID, TELEGRAM_API_HASH. Leave TELEGRAM_SESSION empty on first run - the agent prints a QR code to log in, then writes the session string back into .env. ORCHESTRATOR_URL and COMMUNICATOR_URL default to local plain connections. REMOTE_SESSION_DIRS and CLAUDE_BIN control remote code sessions; ALLOWED_COMMANDS / BLOCKED_PATTERNS are the execution guardrails.

Dependencies

Node 20 (Docker uses node:20-alpine). node-pty and sharp build native bindings, so a C/C++ toolchain + python3 must be present for npm install.

@orchestrator/sdk is vendored under ./sdk (referenced as file:./sdk) - a point-in-time copy from the orchestrator repo (group jaskier-os, path sdk/). To update, re-copy the SDK from there and re-run npm install.

Ver o original no GitHub

Bom para

Relacionados