by nuphos
Open-source Grok Bot alternative for teams. Always-on bots that run on your Claude Code or Codex subscription, in chats your whole team can join.
# Add to your Claude Code skills
git clone https://github.com/nuphos/nuphosGuides for using ai agents skills like nuphos.
See how nuphos compares with popular alternatives.
nuphos is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by nuphos. Open-source Grok Bot alternative for teams. Always-on bots that run on your Claude Code or Codex subscription, in chats your whole team can join. It has 706 GitHub stars.
nuphos's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/nuphos/nuphos" and add it to your Claude Code skills directory (see the Installation section above).
nuphos is primarily written in TypeScript. It is open-source under nuphos on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh nuphos against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.

The open source Grok Bot alternative for teams.
Nuphos is an open source (Apache-2.0) alternative to xAI's Grok Bot. It gives you always-on Bots that run on the Claude Code or Codex subscription you already pay for, on a managed cloud computer or a machine you own, in chats your whole team can join.
What sets Nuphos apart is the team. Your teammates work with a Bot in the same live session, see the same tool calls, and steer it together. Nuphos is not affiliated with xAI.
| Path | What it is |
|---|---|
apps/backend |
Bun/Hono API: accounts, teams, sessions, runtime registry, integrations |
apps/desktop |
Electron/Vite/React client — the workspace itself |
apps/runtime |
Claude Code / Codex container images, adapters and independent releases |
apps/ios |
SwiftUI client: pick a session back up away from your desk |
apps/android |
Jetpack Compose client for Nuphos Cloud or a self-hosted backend |
See apps/android/README.md for Android build and test
instructions. The Android client defaults to Nuphos Cloud, and Server
settings on its welcome screen takes the HTTPS address of a self-hosted
backend. A self-hosted session gets no push notifications, only local ones.
The agent runtime lives in apps/runtime (Apache-2.0).
Its image executes a turn, and a self-hosted deployment registers its own.
See apps/runtime/README.md for building, running
and independently releasing the runtime.
Maintainers publish Desktop downloads and self-hosted Backend images through
component-specific release tags. See the release guide for
versioning, required approvals, and signing setup. Hosted-service deployment is
managed separately. Read it before planning or cutting any release; the runtime
has its own runtime-vX.Y.Z tags, covered in
apps/runtime/README.md. Automated releases may only
produce Patch or Minor versions — a Major needs an explicit manual X.0.0.
Railway currently uses the CLI deployment guide rather than a published one-click template.
deploy/compose brings up a complete, minimal Nuphos with one
docker compose up — MongoDB, S3-compatible storage, the backend, and one agent
runtime. Start at deploy/compose/README.md.
Railway project templates are also available. For Kubernetes, install the Helm chart.
What to know before you plan around it:
nuphos-admin in the backend image creates the first user and
team and prints sign-in codes and server join tokens (see the
Helm README). A launch-time NUPHOS_API_URL (as
bun run dev sets) is Desktop's starting endpoint and can still be changed.
Google sign-in goes through the nuphos.ai web page, so it only works
against Nuphos Cloud.Not available self-hosted: managed runtime provisioning, managed backups, and the operational tooling that comes with running this as a service.
The GUI panes are not screenshots — the agent operates the accounts behind them. Cloud providers are the sharpest case: AWS access is a cross-account assume-role and GCP is service-account impersonation, so your deployment's identity has to be the trusted principal on the other side. A self-hosted instance binds accounts to itself, not to nuphos.ai.
See CONTRIBUTING.md. CI runs on every pull request: typecheck, tests, lint, import-cycle and format checks across the apps your change touches.
apps/backend.apps/desktop.openssl for the local stack bun run dev runs on.openab binary, which
bun run dev builds from apps/runtime/openab. The build installs the pinned toolchain itself.NUPHOS_JWT_SECRET for Nuphos auth flows.Prettier is configured once at the repo root (.prettierrc.json), with per-app
overrides so each app keeps the semicolon/quote style it already uses. ESLint is
per-app, because each app has a different package manager and framework preset.
bun install # at the repo root — installs Prettier
bun run format # rewrite
bun run format:check # report only (what CI runs)
cd apps/backend && bun run lint # type-aware: no-floating-promises, no-misused-promises
cd apps/desktop && pnpm lint # react-hooks / react-refresh
A format-only hook lives in .githooks/. It is opt-in — enable it once per
clone:
git config core.hooksPath .githooks
It runs prettier --check on staged files only. It deliberately does not run
ESLint: the backend config is type-aware, so a lint pass builds a full
TypeScript program and is far too slow for a commit hook. Use
git commit --no-verify to bypass it.
From the repository root:
bun run dev
It starts the local stack, backend, runtime and Electron Desktop with isolated configuration. Do not start Desktop on its own or use the web-only Vite server as the default dev loop.
bun run e2e
It starts a MongoDB, the backend, OpenAB and the Desktop app, all on free ports and with a profile of their own, and walks the app through the flows people use most: sign in, send a message and read the reply, queue a message and press Stop, answer an agent's question from its card and from the Inbox. A scripted agent stands in for the model, so no model