jankoritak · Aug 5, 2026 · Aug 5, 2026 · Aug 13, 2026 · Aug 5, 2026 · Aug 5, 2026
@@ -852,6 +852,41 @@ deepnote integrations edit <integration-id>
 
 Like `integrations pull`, both commands fail with exit code 2 and leave all files untouched if the integrations file contains invalid YAML.
 
+### `notebooks rename <notebook-id> <new-name>`
+
+Rename a notebook in Deepnote Cloud.
+
+```bash
+deepnote notebooks rename <notebook-id> "New name"
+```
+
+**Options:**
+
+| Option                  | Description                                                                     | Default      |
+| ----------------------- | ------------------------------------------------------------------------------- | ------------ |
+| `--url <url>`           | Deepnote API base URL                                                           | Deepnote API |
+| `--token <token>`       | API token (or use `DEEPNOTE_TOKEN` env var or `.env` file in current directory) |              |
+| `-o, --output <format>` | Output format: `json`                                                           |              |
+
+**Examples:**
+
+```bash
+# Rename a notebook by its ID
+deepnote notebooks rename 7061f86dec6e4e11893288f295a82017 "Quarterly report"
+
+# Machine-readable output
+deepnote notebooks rename 7061f86dec6e4e11893288f295a82017 "Quarterly report" --output json
+```
+
+JSON output returns `{ "success": true, "notebook": { "id", "projectId", "name", "isInit" } }`; `isInit`
+is `true` when the notebook is the project's init notebook after the rename.
+
+Renaming fails with a conflict when another notebook in the project already uses the name, when the project is suspended, and for single-notebook or Agent projects, where the project owns its notebook's name.
+
+Naming a notebook `Init` designates it as the project's init notebook in Deepnote. This is a
+functional change, not only a cosmetic rename: the init notebook can run as a prelude to other
+notebooks in the project.
+
 ### `completion <shell>`
 
 Generate shell completion scripts for tab completion.

@@ -1,8 +1,22 @@
+import { execFileSync } from 'node:child_process'
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
 import { createProgram, run } from './cli'
 import { resetOutputConfig } from './output'
 import { version } from './version'
 
+function runBashCompletion(script: string, words: string[]): string[] {
+  const invocation = [
+    script,
+    'COMP_WORDS=("$@")',
+    `COMP_CWORD=$((\${#COMP_WORDS[@]} - 1))`,
+    '_deepnote_completions',
+    `printf '%s\\n' "\${COMPREPLY[@]}"`,
+  ].join('\n')
+  const output = execFileSync('bash', ['-c', invocation, 'bash', ...words], { encoding: 'utf8' })
+
+  return output.trim().split('\n').filter(Boolean)
+}
+
 describe('CLI', () => {
   beforeEach(() => {
     resetOutputConfig()
@@ -83,6 +97,16 @@ describe('CLI', () => {
       expect(completionCmd?.description()).toBe('Generate shell completion scripts')
     })
 
+    it('notebooks rename command is properly configured', () => {
+      const program = createProgram()
+      const notebooksCmd = program.commands.find(cmd => cmd.name() === 'notebooks')
+      const renameCmd = notebooksCmd?.commands.find(cmd => cmd.name() === 'rename')
+
+      expect(renameCmd).toBeDefined()
+      expect(renameCmd?.description()).toBe('Rename a notebook in Deepnote Cloud')
+      expect(renameCmd?.options.map(option => option.flags)).toContain('-o, --output <format>')
+    })
+
     it('schedule command is properly configured', () => {
       const program = createProgram()
       const scheduleCmd = program.commands.find(cmd => cmd.name() === 'schedule')
@@ -176,6 +200,23 @@ describe('CLI', () => {
         return 0
     fi`)
       expect(output).toContain('--storage-mode --timeout --push --yes --url')
+      expect(runBashCompletion(output, ['deepnote', 'notebooks', 'rename', 'notebook-id', 'New name', '--'])).toEqual([
+        '--url',
+        '--token',
+        '--output',
+      ])
+      expect(runBashCompletion(output, ['deepnote', 'notebooks', 'rename', 'notebook-id', 'New name', '-'])).toEqual([
+        '-o',
+        '--url',
+        '--token',
+        '--output',
+      ])
+      expect(
+        runBashCompletion(output, ['deepnote', 'notebooks', 'rename', 'notebook-id', 'New name', '--output', ''])
+      ).toEqual(['json'])
+      expect(
+        runBashCompletion(output, ['deepnote', 'notebooks', 'rename', 'notebook-id', 'New name', '-o', ''])
+      ).toEqual(['json'])
       consoleSpy.mockRestore()
     })
 
@@ -298,6 +339,15 @@ describe('CLI', () => {
         'Invalid output format'
       )
     })
+
+    it('errors when invalid output format is used with notebooks rename', async () => {
+      const program = createProgram()
+      program.exitOverride()
+
+      await expect(
+        program.parseAsync(['notebooks', 'rename', 'notebook-id', 'New name', '-o', 'yaml'], { from: 'user' })
+      ).rejects.toThrow('Invalid output format')
+    })
   })
 
   describe('invalid option values', () => {

@@ -15,6 +15,7 @@ import { createIntegrationsPullAction } from './commands/integrations'
 import { createIntegrationsAddAction } from './commands/integrations/add-integration'
 import { createIntegrationsEditAction } from './commands/integrations/edit-integration'
 import { createLintAction } from './commands/lint'
+import { createNotebooksRenameAction } from './commands/notebooks/rename-notebook'
 import { createOpenAction } from './commands/open'
 import { createPublishAction } from './commands/publish'
 import { createRunAction } from './commands/run'
@@ -1155,6 +1156,38 @@ ${c.bold('Examples:')}
     .option('--file <path>', 'Path to integrations file', DEFAULT_INTEGRATIONS_FILE)
     .option('--env-file <path>', 'Path to .env file for storing secrets', DEFAULT_ENV_FILE)
     .action(createIntegrationsEditAction(program))
+
+  // Notebooks command group - manage notebooks in Deepnote Cloud
+  const notebooksCmd = program
+    .command('notebooks')
+    .description('Manage notebooks in Deepnote Cloud')
+    .addHelpText('after', () => {
+      const c = getChalk()
+      return `
+${c.bold('Subcommands:')}
+  rename      Rename a notebook in Deepnote Cloud
+
+${c.bold('Examples:')}
+  ${c.dim('# Rename a notebook by its ID')}
+  $ deepnote notebooks rename <notebook-id> "New name"
+
+  ${c.dim('# Rename with a specific token')}
+  $ deepnote notebooks rename <notebook-id> "New name" --token <token>
+
+  ${c.dim('# Machine-readable output')}
+  $ deepnote notebooks rename <notebook-id> "New name" --output json
+`
+    })
+
+  notebooksCmd
+    .command('rename')
+    .description('Rename a notebook in Deepnote Cloud')
+    .argument('<notebook-id>', 'ID of the notebook in Deepnote Cloud')
+    .argument('<new-name>', 'New notebook name')
+    .option('--token <token>', `Deepnote API token (defaults to ${DEEPNOTE_TOKEN_ENV})`)
+    .option('--url <url>', 'Deepnote API base URL', DEFAULT_API_URL)
+    .option('-o, --output <format>', 'Output format: json', createFormatValidator(['json']))
+    .action(createNotebooksRenameAction(program))
 }
 
 /**