@gradien/core-agent-setup
v0.1.5
Published
Agent-run setup helper for connecting Core MCP to local and web agent harnesses.
Downloads
615
Readme
Core Agent Setup
Agent-run setup helper for connecting Core MCP to Codex, Claude Code, Cursor, ChatGPT, Claude, and other MCP-capable agent harnesses.
Core is personal cloud memory for AI-native work. This package is meant to be run by the user's agent after the user pastes the Core setup guide into that agent.
Usage
npx -y @gradien/core-agent-setup install --base-url https://core.gradien.ai --yesFor local Core MCP stack testing:
npx -y @gradien/core-agent-setup install --base-url http://127.0.0.1:4107 --server-name core-local --yesWhat It Does
- Detects the current agent harness when possible.
- Creates a short-lived Core setup session.
- Opens Core signup/login in the browser.
- Waits for the browser callback to confirm setup.
- Configures supported local harnesses where the agent has shell access.
- For Cursor, merges Core into
~/.cursor/mcp.json, preserving existing servers and writing a timestamped backup first. - Prints short human steps for apps that require manual settings changes.
The setup flow should not ask users to paste long-lived secrets into chat. When the current app requires a human step, the agent should give a short app-specific handoff and continue after the user confirms.
Cursor users should reload Cursor after setup. If Core appears with only
mcp_auth, run that tool or authenticate from Cursor MCP settings to finish
OAuth.
Commands
core-agent-setup install
core-agent-setup doctor
core-agent-setup print-human-steps --harness chatgptCommon options:
--base-url <url> Core base URL
--harness <name> codex, claude-code, claude-web, claude-desktop, chatgpt, cursor, vscode, windsurf, hermes, opencode, generic
--server-name <name> MCP server name to configure, defaults to core
--yes Execute safe local harness setup commands
--dry-run Print the setup plan without changing local config
--no-browser Print the login URL instead of opening a browserAgent Prompt
Agents should start from:
Please help me set up Core. Use this official setup guide as reference documentation: https://gradien.ai/core/agent-setup/guide.md