@@ -195,6 +195,37 @@ jobs:
           token: ${{ secrets.CODECOV_TOKEN }}
           files: ./coverage/lcov.info
           fail_ci_if_error: true
+  cli-e2e:
+    name: CLI E2E
+    runs-on: ubuntu-latest
+    timeout-minutes: 3
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@41ff72655975bd51cab0327fa583b6e92b6d3061 # v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build packages
+        run: pnpm run build
+
+      - name: Test CLI --version
+        run: node dist/bin.js --version
+        working-directory: packages/cli
+
+      - name: Test CLI --help
+        run: node dist/bin.js --help
+        working-directory: packages/cli
   license-check:
     name: License Check
     runs-on: ubuntu-latest
 
@@ -123,5 +123,17 @@
   "assist": {
     "enabled": true,
     "actions": { "source": { "organizeImports": "on" } }
-  }
+  },
+  "overrides": [
+    {
+      "includes": ["packages/cli/**"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noConsole": "off"
+          }
+        }
+      }
+    }
+  ]
 }
@@ -0,0 +1,5 @@
+src/
+*.ts
+!*.d.ts
+tsdown.config.ts
+.npmignore
@@ -0,0 +1,19 @@
+# Contributing to @deepnote/cli
+
+## Development
+
+```bash
+# Install dependencies (from repo root)
+pnpm install
+
+# Build the CLI
+pnpm build
+
+# Run the CLI in development mode (without building)
+pnpm dev --help
+pnpm dev --version
+pnpm dev inspect path/to/file.deepnote
+
+# Run tests
+pnpm test
+```
@@ -0,0 +1,37 @@
+# @deepnote/cli
+
+Command-line interface for running Deepnote projects locally and on Deepnote Cloud.
+
+This project is under active development and is not ready for use. Expect breaking changes.
+
+## Quick Start
+
+```bash
+# Show help
+deepnote --help
+
+# Show version
+deepnote --version
+
+# Inspect a .deepnote file
+deepnote inspect path/to/file.deepnote
+```
+
+## Commands
+
+### `inspect <path>`
+
+Inspect and display metadata from a `.deepnote` file.
+
+```bash
+deepnote inspect my-project.deepnote
+```
+
+This command displays:
+
+- File path
+- Project name and ID
+- File format version
+- Creation, modification, and export timestamps
+- Number of notebooks and blocks
+- List of notebooks with their block counts
@@ -0,0 +1,55 @@
+{
+  "name": "@deepnote/cli",
+  "version": "0.1.0",
+  "description": "Command-line interface for running Deepnote projects locally and on Deepnote Cloud",
+  "keywords": [
+    "cli",
+    "deepnote",
+    "notebook",
+    "data-science"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deepnote/deepnote.git",
+    "directory": "packages/cli"
+  },
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "deepnote": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsx src/bin.ts",
+    "test": "vitest",
+    "watch": "tsdown --watch"
+  },
+  "dependencies": {
+    "@deepnote/blocks": "workspace:*",
+    "chalk": "^5.4.1",
+    "commander": "^14.0.2"
+  },
+  "devDependencies": {
+    "tsx": "^4.20.6"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  }
+}
@@ -0,0 +1,22 @@
+import { afterEach, describe, expect, it, vi } from 'vitest'
+
+vi.mock('./cli', () => ({
+  run: vi.fn(),
+}))
+
+describe('bin', () => {
+  afterEach(() => {
+    vi.clearAllMocks()
+  })
+
+  it('calls run() when imported', async () => {
+    vi.resetModules()
+
+    const { run } = await import('./cli')
+
+    await import('./bin')
+
+    expect(run).toHaveBeenCalledTimes(1)
+    expect(run).toHaveBeenCalledWith()
+  })
+})
@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from './cli'
+
+run()
@@ -0,0 +1,40 @@
+import { describe, expect, it } from 'vitest'
+import { createProgram, run } from './cli'
+import { version } from './version'
+
+describe('CLI', () => {
+  describe('createProgram', () => {
+    it('creates a program with correct name', () => {
+      const program = createProgram()
+      expect(program.name()).toBe('deepnote')
+    })
+
+    it('has version set', () => {
+      const program = createProgram()
+      expect(program.version()).toBe(version)
+    })
+
+    it('has expected commands registered', () => {
+      const program = createProgram()
+      const commandNames = program.commands.map(cmd => cmd.name())
+
+      expect(commandNames).toContain('inspect')
+    })
+  })
+
+  describe('commands', () => {
+    it('inspect command is properly configured', () => {
+      const program = createProgram()
+      const inspectCmd = program.commands.find(cmd => cmd.name() === 'inspect')
+
+      expect(inspectCmd).toBeDefined()
+      expect(inspectCmd?.description()).toBe('Inspect and display metadata from a .deepnote file')
+    })
+  })
+
+  describe('run', () => {
+    it('is exported and callable', () => {
+      expect(typeof run).toBe('function')
+    })
+  })
+})
@@ -0,0 +1,61 @@
+import chalk from 'chalk'
+import { Command } from 'commander'
+import { createInspectAction } from './commands/inspect'
+import { version } from './version'
+
+/**
+ * Creates and configures the main CLI program.
+ */
+export function createProgram(): Command {
+  const program = new Command()
+
+  program
+    .name('deepnote')
+    .description(getWelcomeText())
+    .version(version, '-v, --version', 'Display the CLI version')
+    .helpOption('-h, --help', 'Display help information')
+    .showHelpAfterError(false)
+    .configureOutput({
+      // Write errors to stderr with chalk styling
+      outputError: (str, write) => write(chalk.red(str)),
+    })
+
+  // Register placeholder commands (to be implemented in future phases)
+  registerCommands(program)
+
+  return program
+}
+
+/**
+ * Registers all available commands on the program.
+ */
+function registerCommands(program: Command): void {
+  // Inspect command - for inspecting and displaying .deepnote file metadata
+  program
+    .command('inspect')
+    .description('Inspect and display metadata from a .deepnote file')
+    .argument('<path>', 'Path to .deepnote file')
+    .action(createInspectAction(program))
+}
+
+/**
+ * Returns the welcome text displayed in help output.
+ */
+function getWelcomeText(): string {
+  return `${chalk.bold.cyan('Deepnote CLI')} - Run Deepnote projects from the command line
+
+${chalk.dim('Run .deepnote files locally or on Deepnote Cloud for data science workflows,')}
+${chalk.dim('automation, CI/CD pipelines, and interactive development.')}
+
+${chalk.dim('Documentation:')} ${chalk.underline('https://deepnote.com/docs/getting-started')}
+${chalk.dim('Repository:')}    ${chalk.underline('https://github.com/deepnote/deepnote')}`
+}
+
+/**
+ * Parses command line arguments and runs the CLI.
+ * This is the main entry point for the CLI.
+ */
+export function run(argv?: string[]): void {
+  const program = createProgram()
+  program.parse(argv ?? process.argv)
+}
-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +src/
 +*.ts
 +!*.d.ts
 +tsdown.config.ts
 +.npmignore