General
What platforms does Jinzo support?
What platforms does Jinzo support?
Jinzo is currently available for macOS only. Windows and Linux support is planned.
Which AI agents are supported?
Which AI agents are supported?
Jinzo supports two agent runtimes: Claude Code (via the Anthropic CLI) and GitHub Copilot (via the Copilot CLI). You can use either or both in your workspaces.
Do I need an API key?
Do I need an API key?
For Claude Code, you need an Anthropic API key or a Claude account authenticated via
claude /login. For GitHub Copilot, you need an active Copilot subscription and GitHub CLI authentication (gh auth status).Where is my data stored?
Where is my data stored?
All data is stored locally in a SQLite database at
~/Library/Application Support/jinzo/jinzo.db on macOS. See the Privacy page for details.Workspaces
What happens when I create a workspace?
What happens when I create a workspace?
Jinzo creates an isolated Git worktree for the workspace. This gives the workspace its own working directory and branch while sharing Git history with the original repository.
Can I run multiple agents at the same time?
Can I run multiple agents at the same time?
Yes. Each workspace has its own Git worktree, so multiple agent sessions can run in parallel without file conflicts. See Multi Session.
What happens when I archive a workspace?
What happens when I archive a workspace?
The workspace is hidden from the sidebar and its worktree is cleaned up to free disk space. The workspace data remains in the database and can be restored if needed.
Connections
Which services can I connect?
Which services can I connect?
How are my credentials stored?
How are my credentials stored?
API tokens and OAuth credentials are stored encrypted in the local database. They never leave your machine.
How often does data sync?
How often does data sync?
The initial sync fetches existing data. Subsequent syncs are incremental and can be triggered manually or configured on a schedule from Settings > Schedules.
Troubleshooting
Claude Code agent is not available
Claude Code agent is not available
Make sure the Claude CLI is installed and authenticated. Run
claude /login in your terminal to verify. Jinzo requires the Claude CLI binary to be accessible from your system PATH.GitHub Copilot agent is not available
GitHub Copilot agent is not available
Verify your GitHub CLI authentication with
gh auth status and ensure you have an active Copilot subscription. The Copilot CLI binary must be accessible from your system PATH.Workspace worktree creation fails
Workspace worktree creation fails
This can happen if the repository already has a worktree at the target path, or if there are uncommitted changes in the source repo that conflict. Try running
git worktree list in your terminal to check existing worktrees, and git worktree prune to clean up stale entries.Agent run is stuck or unresponsive
Agent run is stuck or unresponsive
You can abort a running session from the workspace UI. If the agent is waiting for tool approval, check for a pending approval dialog in the workspace. If the run remains stuck, try restarting the app — active runs are tracked and can be recovered.
MCP server tools are not showing up
MCP server tools are not showing up
MCP servers must be registered before starting a session. Add servers via
claude mcp add and verify with claude mcp list. Restart the workspace session after adding new servers.Synced issues are not appearing
Synced issues are not appearing
Go to Settings > Apps and verify your connection is active. Check that you’ve selected the correct repositories, teams, or projects to sync. Trigger a manual sync to refresh data.
Database reset
Database reset
If you need to reset the local database, delete the file at
~/Library/Application Support/jinzo/jinzo.db and restart Jinzo. This removes all local data including workspaces, runs, and connection credentials.macOS security warning on first launch
macOS security warning on first launch
macOS may block Jinzo since it’s downloaded from the internet. Go to System Settings > Privacy & Security and click Open Anyway, or right-click the app and select Open to bypass the warning.
macOS Keychain prompt: "jinzo wants to use your confidential information"
macOS Keychain prompt: "jinzo wants to use your confidential information"
On launch, macOS may show a dialog saying jinzo wants to use your confidential information stored in “jinzo Safe Storage” in your keychain. This is expected — Jinzo uses Electron’s
safeStorage API to encrypt sensitive data like connection tokens and API keys. macOS requires your permission before an app can access its own Keychain entry.- Click Allow to grant access for this session
- Click Always Allow to stop the prompt from appearing again
- Clicking Deny will prevent Jinzo from reading encrypted credentials, which may cause connection features to fail
