---
id: jupyter-ai-chat-commands
version: "0.0.4"
license: BSD 3-Clause License Copyright (c) 2025, Project Jupyter All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# jupyter-ai-chat-commands — Package providing the set of default chat commands in Jupyter AI.

License: permissive · Maintenance: active · Downloads: 80.1K/mo

## What it is and what it does

jupyter-ai-chat-commands is a JupyterLab extension that adds two built-in chat commands to Jupyter AI: @file: for attaching files to chat messages, and /refresh-personas for reloading locally-defined personas from the .jupyter/personas directory. It consists of both a Python server extension and a frontend NPM package that integrate with the Jupyter AI ecosystem.

The package requires JupyterLab >= 4.0.0 and Python >= 3.10. It depends on jupyter-ai-persona-manager, jupyter-ai-router, jupyter-server, and jupyterlab-chat. Installation is straightforward via pip, and the extension is enabled automatically; troubleshooting involves checking jupyter server extension list and jupyter labextension list if the commands do not appear.

Use it for:

- Attach local files to AI chat messages without manual copy-paste in JupyterLab notebooks.
- Reload custom AI personas from .jupyter/personas directory without restarting JupyterLab.
- Extend Jupyter AI chat interface with file-based context for code review or documentation tasks.
- Manage multiple AI personas for different workflows within a single JupyterLab session.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides default chat commands for Jupyter AI, including file attachment and persona management within JupyterLab.

Yes, if you use Jupyter AI and need file attachment or persona management in chat. The package is actively maintained, has low install friction, carries a permissive BSD 3-Clause License, and has no known vulnerabilities. It is a straightforward extension to core Jupyter AI functionality with no notable blockers.

## Install

pip install jupyter-ai-chat-commands
uv add jupyter-ai-chat-commands
poetry add jupyter-ai-chat-commands

## Installing jupyter-ai-chat-commands

Before you install: Low install friction with a pure Python wheel. Active maintenance as of 2026-08-11. Depends on jupyter-server and jupyterlab-chat, which are standard Jupyter ecosystem packages.

License in practice: BSD 3-Clause License permits commercial and private use with minimal restrictions; you may use, modify, and distribute provided you retain copyright notices and disclaimers.

Quickstart:

pip install jupyter_ai_chat_commands

Then verify installation:
jupyter server extension list
jupyter labextension list

Requires JupyterLab >= 4.0.0 and Python >= 3.10

Verify before relying:

- Whether the @file: command supports all file types or has size/format restrictions.
- Whether personas in .jupyter/personas are auto-discovered or require explicit registration.
- Performance impact when managing large numbers of custom personas.

## Package facts

- License: BSD 3-Clause License Copyright (c) 2025, Project Jupyter All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 80.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

jupyter ai chat commands, jupyterlab chat extension, jupyter ai file attachment, jupyterlab persona management, jupyter ai extension, jupyterlab-extension, jupyter-ai

[View on SkillFed](https://skillfed.io/packages/jupyter-ai-chat-commands) · [View on PyPI](https://pypi.org/project/jupyter-ai-chat-commands/)