Powered by Google ADK with Gemini or Ollama. Execute commands, stream logs in real-time, and build custom skills through natural language.
Everything you need to automate deployments and streamline operations.
Execute shell commands remotely via HTTP API. Perfect for CI/CD pipelines and automation.
Watch deployments live with Server-Sent Events. See stdout and stderr as they happen.
Natural language commands powered by Google's ADK. Just tell it what you need.
Add integrations like Slack, Gmail, and more. Configure once, use everywhere.
Token-based authentication. Runs in your infrastructure. Your data stays yours.
Complete audit trail with persisted logs. Browse, search, and debug past deployments.
Create your own skills through chat. Define command shortcuts, AI personas, or multi-step workflows.
Full Gmail access via OAuth2. Read, search, and reply to emails. Analyze messages with AI.
Set up cron or interval-based autopilot schedules. Trigger prompts or command skills on a timer.
Manage every agent from one dashboard. The Control Center mirrors executions into local SQLite and keeps history queryable.
Export the entire Control Center as JSON or SQLite from Settings → Database. Restore on a new host in minutes.
Every conversation is saved per agent. New chats, search, and rewind to any previous thread from the sidebar.
Use built-in integrations or create your own custom skills through natural language.
Deployment notifications and slash commands
Send emails via Gmail SMTP
Send through any SMTP server
AI wingman that learns your style
Full inbox access via OAuth2
Build your own skills via chat
Follow these steps to deploy your own Griphook instance.
Do not expose GRIPHOOK to the public internet. This system executes shell commands on your servers and should only be deployed in a private, secured environment accessible to you and authorized personnel only.
For secure remote access, use a zero-trust tunnel solution:
Every method the interactive installer supports, grouped by OS. The one-liner above picks the right one automatically; these are the individual commands if you want to script it.
Recommended path. Runs the agent and UI in isolated containers — no need to install Java, Node, or Git. Works on every Mac.
brew install --cask docker && open -a Docker
curl -fsSL https://griphook.dev/install.sh | bash -s -- --docker
For native macOS. The installer builds the agent JAR, sets up a launchd service, and runs the UI under node. No virtualization, no containers.
brew install openjdk@21 node@22 git && curl -fsSL https://griphook.dev/install.sh | bash -s -- --jar
For contributors. Clones the repo, runs ./gradlew bootJar, installs a launchd service. Use this if you plan to edit the source.
brew install openjdk@21 node@22 git && curl -fsSL https://griphook.dev/install.sh | bash -s -- --source
Recommended path. The installer auto-detects your package manager and installs Docker if missing. Then it runs the agent and UI in containers — no host pollution, no version conflicts.
curl -fsSL https://griphook.dev/install.sh | bash -s -- --docker
apt / dnf / pacman / zypper.
For bare-metal or VMs. The installer builds the agent JAR, creates a systemd service, and runs the UI under node. Native performance.
curl -fsSL https://griphook.dev/install.sh | bash -s -- --jar
For contributors. Clones the repo, runs ./gradlew bootJar, installs a systemd service. Use this if you plan to edit the source.
curl -fsSL https://griphook.dev/install.sh | bash -s -- --source
For trying it out. Runs Griphook inside a Docker container with systemd, exposed on localhost:8090 and :3000. Great for demos and quick experiments — not for production.
curl -fsSL https://griphook.dev/install.sh | bash -s -- --sandbox
Run in an elevated PowerShell. The installer pulls Java 21, Node 22, and Git via winget, builds both halves, and registers two Windows services (Griphook + GriphookUI) via NSSM.
irm https://griphook.dev/install.ps1 | iex
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
If iex feels weird. The .bat file auto-requests UAC elevation and bypasses PowerShell execution policy. Useful for double-click installs.
curl -fsSL https://griphook.dev/install.bat -o install.bat && install.bat
For adding a Windows agent to a UI already running elsewhere. Skips the UI install — only the agent JAR and Griphook service get installed. Register the agent in the UI via Manage Agents → Add after.
irm https://griphook.dev/install.ps1 | iex -SkipUI
The installer creates platform-native services so Griphook auto-starts on boot. Here's how to control them on each OS.
Service plists land in ~/Library/LaunchAgents/.
launchctl list | grep griphook
launchctl unload ~/Library/LaunchAgents/dev.griphook.agent.plist
launchctl load ~/Library/LaunchAgents/dev.griphook.agent.plist
Units at /etc/systemd/system/griphook-*.service.
systemctl status griphook-agent griphook-ui
sudo systemctl restart griphook-agent
sudo journalctl -u griphook-agent -f
Two services: Griphook + GriphookUI.
Get-Service Griphook, GriphookUI
Restart-Service Griphook, GriphookUI
Stop-Service Griphook, GriphookUI
Open the dashboard at http://localhost:3000 (agent on http://localhost:8090). The setup wizard will prompt you to connect your first agent on launch — have your AGENT_TOKEN ready.
Griphook uses Google ADK for AI chat. Pick Gemini (cloud) or Ollama (local) — both are optional and can be configured anytime from Settings → AI Configuration with no restart. The setup wizard only asks you to connect an agent.
1234 (dev only).
ollama (with minimax-m3:cloud). Set to gemini to use Google Gemini instead. Optional — configure later from Settings.
Launch the agent with Docker Compose or the standalone JAR. Note the AGENT_TOKEN — you'll need it to connect from the UI.
docker compose -f docker-compose.prod.yml up -d
The setup wizard launches on first run and asks you to connect your agent.
http://localhost:3000
Enter the agent URL (e.g. http://agent-1:8090 from the compose network, or http://localhost:8090) and the AGENT_TOKEN from the backend.
Pick Gemini or Ollama from Settings → AI Configuration anytime — no restart needed. Both are optional.
POST commands to the API, use the chat interface, or trigger from your CI/CD pipeline.
curl http://localhost:8090/health
Get up and running in minutes.
Run the Docker container on your server or use the standalone JAR. Set your API token.
Enable built-in skills like Slack and Gmail, or create your own custom skills through chat.
POST commands to the API, use the chat interface, or trigger from your CI/CD pipeline.
Execute multi-step deployments with a single HTTP request. Each step runs sequentially with full output capture.
Deploy Griphook in minutes on macOS, Linux, or Windows. Free, open source, and completely self-hosted. Back up the whole Control Center in one click from Settings → Database.