Push to Inkeep Cloud

This tutorial walks you through pushing agent configurations to Inkeep Cloud.

Prerequisites

• Access to Inkeep Cloud or a self-hosted deployment
• The Inkeep CLI installed globally:

npm install -g @inkeep/agents-cli

• A CLI profile configured and authenticated (only needed for remote deployments). If you haven't done this yet, follow the Set up a CLI profile tutorial.

Step 1: Navigate to your project

Navigate to your project directory. A project directory contains an index.ts file that exports a project definition:

cd my-project

Step 2: Push to Inkeep Cloud

Run the push command:

inkeep push

The CLI will:

1. Detect the project from your index.ts file
2. Resolve configuration — your active CLI profile overrides inkeep.config.ts for API URLs, API key, and tenant ID (see Configuration Priority)
3. Push all agents, tools, and configurations to Inkeep Cloud

Step 3: Verify the push

After a successful push, the CLI prints a deployment summary with resource counts. You can also verify by opening the Visual Builder to see your updated configurations.

Push all projects at once

If you have multiple projects in a workspace, push them all:

inkeep push --all

What's next