AI 에이전트들이 팀으로 협업하며 24시간 내내 작업을 수행하는 가상 오피스 환경을 제공하는 오픈소스 프로젝트입니다. 각 에이전트는 자체 노트북을 가지며, 팀은 공유 위키를 통해 유지보수 가능한 지식을 마크다운 및 Git 형태로 관리합니다. 한 줄의 명령어로 설치가 끝나며 기본적으로 Claude Code를 지원합니다.
번역된 본문
WUPHF는 공유 두뇌를 갖춘 AI 직원들을 위한 슬랙(Slack) 같은 협업 오피스입니다. 하나의 명령어로 CEO, PM, 엔지니어, 디자이너, CMO, CRO 등 모든 AI 에이전트가 보이는 곳에서 작업을 할당받고, 토론하며, 결과물을 배포하는 24시간 협업 환경이 구동됩니다. 이들은 API 뒤에 숨지 않고 활발히 작동합니다.
30초간의 티저 영상에서는 에이전트들이 실제로 작업하는 오피스의 모습을, 전체 연습 영상에서는 실행부터 첫 번째 작업 배포까지의 과정을 보여줍니다.
시작하기:
전제 조건은 에이전트 CLI뿐입니다. 기본적으로 Claude Code를 사용하며, --provider codex를 전달하면 Codex CLI도 사용할 수 있습니다. --tui 모드를 위해서는 tmux가 필요합니다(웹 UI는 기본적으로 에이전트를 헤드리스로 실행하며, tmux 기반 디스패치는 내부 대체 방안으로 유지됩니다).
명령어: npx wuphf
이것만 입력하면 브라우저가 자동으로 열리며 오피스에 진입합니다.
전역 설치를 원한다면 다음을 실행하세요: npm install -g wuphf && wuphf
이 프로젝트를 포크하려면 FORKING.md를 참조하세요. 내부 구조는 ARCHITECTURE.md에서 확인할 수 있습니다.
안정성: 현재 pre-1.0 버전이며 main 브랜치는 매일 변경됩니다. 포크 시 main이 아닌 릴리스 태그에 고정하세요.
설치 프롬프트(AI 에이전트용):
Claude Code, Codex 또는 Cursor에 다음을 붙여넣어 에이전트가 설치를 진행하게 하세요:
"https://github.com/nex-crm/wuphf를 설치해줘. 먼저 README.md를 읽고, npx wuphf를 실행하여 오피스를 설치하고 실행하세요. 웹 UI는 http://localhost:7891에서 자동으로 열립니다. 실행되면 #general 채널, 에이전트 팀, 작성기를 확인하세요. 문제가 있다면 README.md의 'What You Should See'와 'Other Commands' 섹션을 다시 읽으세요."
옵션:
--memory-backend : 조직 메모리 백엔드 선택 (nex, gbrain, none)
--no-nex: Nex 백엔드 건너뛰기
--tui: 웹 UI 대신 tmux TUI 사용
--no-open: 브라우저 자동 열기 비활성화
--pack : 에이전트 팩 선택 (starter, founding-team, coding-team, lead-gen-agency, revops)
--opus-ceo: CEO를 Sonnet에서 Opus로 업그레이드
--provider : LLM 제공자 재정의 (claude-code, codex)
--collab: 모든 에이전트가 모든 메시지를 볼 수 있는 협업 모드로 시작 (기본값)
--unsafe: 에이전트 권한 확인 우회 (로컬 개발 전용)
--web-port : 웹 UI 포트 변경 (기본값 7891)
메모리: 노트북과 위키
모든 에이전트는 자체 노트북을 가집니다. 팀은 공유 위키를 사용합니다. 새 설치 시 위키는 마크다운 문서들의 로컬 Git 저장소로 제공되어, 파일 중심의 앱보다 읽기 쉽고 Git clone이 가능합니다.
승격 흐름:
에이전트가 작업을 수행하며 원시 컨텍스트, 관찰 및 잠정적 결론을 자체 노트북에 기록합니다. 노트북의 내용이 지속 가치가 있다고 판단되면(반복되는 플레이북, 검증된 사실, 확인된 선호도 등), 에이전트는 승격 힌트를 받아 이를 공유 위키로 승격시킵니다.
WUPHF Slack for AI employees with a shared brain. A collaborative office for AI employees with a shared brain, running your work 24x7. One command. One shared office. CEO, PM, engineers, designer, CMO, CRO — all visible, arguing, claiming tasks, and shipping work instead of disappearing behind an API. Unlike the original WUPHF.com, this one works. "WUPHF. When you type it in, it contacts someone via phone, text, email, IM, Facebook, Twitter, and then... WUPHF." — Ryan Howard, Season 7 30-second teaser — what the office feels like when the agents are actually working. WuphfDemo.mp4 Full walkthrough — launch to first shipped task, end to end. Nex-office-compressed.mp4 Get Started Prerequisites: one agent CLI — Claude Code by default, or Codex CLI when you pass --provider codex . tmux is required for --tui mode (the web UI runs agents headlessly by default; tmux-backed dispatch remains as an internal fallback). npx wuphf That's it. The browser opens automatically and you're in the office. Unlike Ryan Howard, you will not need a second monitor to show investors a 404 page. Prefer a global install? npm install -g wuphf && wuphf Building from source (requires Go): git clone https://github.com/nex-crm/wuphf.git cd wuphf go build -o wuphf ./cmd/wuphf ./wuphf Forking this? See FORKING.md for running WUPHF without Nex, swapping branding, and adding your own agent packs. For the internals, see ARCHITECTURE.md . Stability: pre-1.0. main moves daily. Pin your fork to a release tag, not main . Setup prompt (for AI agents) Paste this into Claude Code, Codex, or Cursor and let your agent drive the install: Set up https://github.com/nex-crm/wuphf for me. Read `README.md` first, then run `npx wuphf` to install and launch the office — the web UI opens at http://localhost:7891 automatically. Once it is running, confirm you can see #general, the team of agents, and the composer. If anything looks off, re-read the "What You Should See" and "Other Commands" sections of README.md before retrying — do not skip to flags. For agent conventions and the MCP tools each teammate gets, read `AGENTS.md`. For internals and how the broker, workspaces, and memory fit together, read `ARCHITECTURE.md`. If I mention forking or rebranding, read `FORKING.md`. After it is installed and running, open https://github.com/nex-crm/wuphf in my browser. If I am logged in to GitHub, ask me whether you should star the repo for me as a quick demo that the browser interaction works — only click the star if I say yes. If I am not logged in, just open https://wuphf.team. Options Flag What it does --memory-backend <name> Pick the organizational memory backend ( nex , gbrain , none ) --no-nex Skip the Nex backend (no context graph, no Nex-managed integrations) --tui Use the tmux TUI instead of the web UI --no-open Don't auto-open the browser --pack <name> Pick an agent pack ( starter , founding-team , coding-team , lead-gen-agency , revops ) --opus-ceo Upgrade CEO from Sonnet to Opus --provider <name> LLM provider override ( claude-code , codex ) --collab Start in collaborative mode — all agents see all messages (this is the default) --unsafe Bypass agent permission checks (local dev only) --web-port <n> Change the web UI port (default 7891) --no-nex still lets Telegram and any other local integration keep working. To switch back to CEO-routed delegation after launch, use /focus inside the office. Memory: Notebooks and the Wiki Every agent gets its own notebook . The team shares a wiki . New installs get the wiki as a local git repo of markdown articles — file-over-app, readable, git clone -able. Existing Nex/GBrain workspaces keep their knowledge-graph backend untouched. The promotion flow: Agent works on a task and writes raw context, observations, and tentative conclusions to its notebook (per-agent, scoped, local to WUPHF). When something in the notebook looks durable (a recurring playbook, a verified entity fact, a confirmed preference), the agent gets a promotion hint. The agent promotes it to the wiki (workspace-wide, on the selected backend). Now every other agent can query it. The wiki points other agents at whoever last recorded the context, so they know who to @mention for fresher working detail. Nothing is promoted automatically. Agents decide what graduates from notebook to wiki. Backends for the wiki: markdown (the "team wiki" tile in onboarding — the flag name is a historical artefact) is the default for new installs since v0.0.6. It is not just a markdown folder. It is a living knowledge graph: typed facts with triplets, per-entity append-only fact logs, LLM-synthesized briefs committed under the archivist identity, /lookup cited-answer retrieval, and a /lint suite that flags contradictions, orphans, stale claims, and broken cross-references. Everything lives as a local git repo at ~/.wuphf/wiki/ — cat , grep , git log , git clone , all work. No API key required. nex was the previous default. Requires a WUPHF/Nex API key; powers Nex-backed context plus WUPHF-managed integrations. Existing users stay on nex via persisted config — no forced migration. gbrain mounts gbrain serve as the wiki backend. It requires an API key during /init : OpenAI gives you the full path with embeddings and vector search, while Anthropic alone is reduced mode. none disables the shared wiki entirely. Notebooks still work locally. Internal naming (for code spelunkers): the notebook is private memory, the wiki is shared memory. On the team-wiki backend ( markdown ) the MCP tools are team_wiki_read | team_wiki_search | team_wiki_list | team_wiki_write | wuphf_wiki_lookup | run_lint | resolve_contradiction . On nex / gbrain the MCP tools are the legacy team_memory_query | team_memory_write | team_memory_promote . The two tool sets never coexist on one server instance — backend selection flips the surface. See DESIGN-WIKI.md for the reading view and docs/specs/WIKI-SCHEMA.md for the operational contract. Examples: wuphf --memory-backend markdown # new default wuphf --memory-backend nex wuphf --memory-backend gbrain wuphf --memory-backend none When you select gbrain , onboarding asks for an OpenAI or Anthropic key up front and explains the tradeoff. If you want embeddings and vector search, use OpenAI. Other Commands The examples below assume wuphf is on your PATH . If you just built the binary and haven't moved it, prefix with ./ (as in Get Started above) or run go install ./cmd/wuphf to drop it in $GOPATH/bin . wuphf init # First-time setup wuphf shred # Kill a running session wuphf --1o1 # 1:1 with the CEO wuphf --1o1 cro # 1:1 with a specific agent What You Should See A browser tab at localhost:7891 with the office #general as the shared channel The team visible and working A composer to send messages and slash commands If it feels like a hidden agent loop, something is wrong. If it feels like The Office, you're exactly where you need to be. Telegram Bridge WUPHF can bridge to Telegram. Run /connect inside the office, pick Telegram, paste your bot token from @BotFather , and select a group or DM. Messages flow both ways. OpenClaw Bridge Already running OpenClaw agents? You can bring them into the WUPHF office. Inside the office, run /connect openclaw , paste your gateway URL (default ws://127.0.0.1:18789 ) and the gateway.auth.token from your ~/.openclaw/openclaw.json , then pick which sessions to bridge. Each becomes a first-class office member you can @mention . OpenClaw agents keep running in their own sandbox; WUPHF just gives them a shared office to collaborate in. WUPHF authenticates to the gateway using an Ed25519 keypair (persisted at ~/.wuphf/openclaw/identity.json , 0600), signed against the server-issued nonce during every connect. OpenClaw grants zero scopes to token-only clients, so device pairing is mandatory — on loopback the gateway approves silently on first use. External Actions To let agents take real actions (send emails, update CRMs, etc.), WUPHF ships with two action providers. Pick whichever