December v0.4.19

CLI Reference

Every command, flag, and keyboard shortcut in the December CLI.

This page lists the commands, flags, and keyboard shortcuts of the December CLI.

Overview

The CLI (@trydecember/cli) runs in your project folder. It reads your files, edits code, and runs commands such as your tests.

# Start an interactive session in the current folder
december

# Run one prompt, print the result, and exit
december --print "Fix the failing unit tests in packages/server"

# Start a session with a specific model
december --model claude-opus-5

If you pass a prompt, December runs it without the interactive session. By default it streams JSON events (NDJSON). Add --print to get plain text.

Global CLI Commands

CommandWhat it does
decemberStart an interactive session.
december "<prompt>"Run one prompt without the interactive session.
december ask "<question>"Ask a question about the code. December only reads files.
december resume [session-id]Resume the last session, or the session with this ID.
december login [provider]Sign in with December. Add a provider name to link a plan.
december link <provider>Link a plan: claude, chatgpt, copilot, gemini, or amazon-q.
december key <provider> [key]Save your own API key for a provider.
december logout [provider]Remove saved sign-in data and keys.
december switch [provider]Change the active provider.
december auth [status|import]Show sign-in status, or import plans from other CLIs on this computer.
december skill listList the installed skills.
december skill add <repo>Install skills from GitHub (for example phasehumans/skills).
december skill info <name>Show the details of a skill.
december skill remove <name>Remove a skill.
december mcp [list]Show the configured MCP servers.
december rewind [turn|list]List saved turns, or restore your files to a turn.
december doctor [--fix]Check the install. Add --fix to repair PATH problems.
december docs [section]Open the documentation in your browser.
december changelogOpen the changelog in your browser.
december updateInstall the latest CLI release.

Flags

FlagWhat it does
-h, --helpShow the help and exit.
-v, --versionShow the CLI version and exit.
-r, --resumeResume the last session.
-m, --model <model>Use this model.
-y, --yesApprove tool calls without asking.
--printPrint plain text for a one-prompt run. Approves tool calls.
--jsonPrint JSON events for a one-prompt run.
--session-id <id>Use this session ID.
--scope <dir>Keep December inside one folder, such as a package.
--cwd <dir>Set the working folder.

In-Session Keyboard Shortcuts

  • Ctrl + C: Stop December or exit the CLI.
  • Esc: Close a menu or clear the input.
  • Ctrl + P / Ctrl + N: Go to the previous or next prompt in your history.
  • Up / Down: Scroll the chat when the prompt is empty.
  • Ctrl + L: Open or close the slash command menu.
  • Ctrl + O: Show or hide tool output.
  • Ctrl + T: Show or hide background tasks.
  • @ and a file name: Add a file to the prompt.
  • ! and a command: Run a shell command directly, for example !git status.

Type /help in a session to see the full list.

In-Session Slash Commands

In a session, type / to see the slash commands. These are the most common:

  • /login: Link a plan, sign in with December, or add your own keys.
  • /model: Pick a model from your connected provider.
  • /clear: Clear the conversation history.
  • /memory: Manage workspace memory (.december/memory.md) and project rules (AGENTS.md).
  • /plan <goal>: Make a plan that you approve before December changes code.
  • /<skill-name>: Run an installed skill.
  • /docs: Open the documentation in your browser.
  • /changelog: Open the changelog in your browser.
  • /exit: Exit the CLI.

See Slash Commands for the full list.