<!--  -->

biscuit is a fast, extensible, native code editor with agents. lightweight <20 mb in size. install and start using in seconds.

• explore popular extensions, visit the new extension marketplace we've been working on
• for developer/user guides & API reference, check documentation, WIP so i recommend checking deepwiki.
• packed with superpowers, list of features

<img alt="biscuit" src="https://github.com/user-attachments/assets/ac5254cc-e1ac-4fe6-a582-51b5129756e3" />

installing

install the latest release by running:

> pip install biscuit-editor

quickly open up a project using biscuit path/to/src and start editing. see other installation methods if you'd like to (like pyinstaller).

<!--  -->

contributing

• please check the docs and contributing guide for a quick tour of the project structure and to set up the environment.
• to make a new extension, read the extension docs :>
• support the work

PROGRESS

agents

• [x] gemini, anthropic API support (claude-4-5-opus/sonnet/haiku, gemini-2-5-flash/pro)
• [x] planning agent with task list
  • [x] ReadFileTool
  • [x] EditFileTool
  • [x] DeleteFileTool
  • [x] ListDirTool
  • [x] GlobFileSearchTool
  • [x] GrepTool
  • [x] CodebaseSearchTool
  • [x] RunTerminalCmdTool
  • [x] TodoWriteTool
  • [x] GetWorkspaceInfoTool
  • [x] GetActiveEditorTool
• [x] add more LLM providers through biscuit extensions
• [x] attach files for adding context in chat
• [ ] LLM provider extension examples (old ones are now deprecated)
• [x] run local LLMs with ~~ollama extension~~ (deprecated)
• [ ] ollama extension rewrite
• [x] LLM calls inside biscuit terminals (use # your prompt inside terminal, then accept/decline response)

code intelligence

• [x] fast tree-sitter based parsing and highlights
• [x] code completions within editor (with icons)
• [x] hover for symbol definition/docstring (rendered with highlights + markdown)
• [x] symbol outline sidebar panel for navigating symbols in open editor
• [x] symbol search through command palette Ctrl + J)
• [x] floating peek widget to jump-to-definition/declaration of symbols
• [x] symbol references in open editor
• [x] adding more language servers through biscuit extensions

more language servers are registered through extensions, see the rust, clangd extensions for reference.

<img alt="lsp and agents" src="https://github.com/user-attachments/assets/30b52da7-af5b-490b-912a-fb8b4d61dcb0" />

source control

• [x] split diff viewer for changes/staged changes
• [x] essential git operations easily accessible (push, pull, commit, stage, unstage, switch branches)
• [x] clone repositories and immediately open in active window, or new window
• [x] view gitHub issues/prs within editor (TODO: disabled rn, will be converted to an extension)

fast search

• [x] ripgrep based fast search, quickly accessible from statusbar
• [x] replace occurrences individually or all at once
• [x] regex support, case sensitive search and more customization
• [x] search within open editors with floating find-replace widget

<img alt="search" src="https://github.com/user-attachments/assets/d4ef7657-f37b-40ab-b9b1-c00d45e7f764" />

code debugging

• [x] setting breakpoints across files
• [x] inspection panel for all runtime variables
• [x] modify runtime variables while debugging
• [x] call stack visualization and exception tracing
• [ ] full DAP client integration
• [x] built-in python debugger
• [x] add debuggers can be registered through biscuit extensions.

extensions

• [x] install and manage all available extensions though a gui
• [x] extension search within biscuit
• [x] extension bootstrapping cli commands and templates
• [x] extension docs
• [x] extensions marketplace website: visit here

<img alt="extensions" src="https://github.com/user-attachments/assets/91ab0044-2eac-4c20-972d-6719002edb1a" />

misc

• [x] split markdown editor, plain HTML renderer
• [x] toggle relative line numbering support
• [ ] vim mode support
• [x] add formatters through biscuit extensions
• [x] formatter extensions: ~~black~~ [DEPRECATED], ~~ruff~~[DEPRECATED], ~~YAPF~~[DEPRECATED], ~~autopep8~~ [DEPRECATED] for reference.
• [x] drag-n-drop to open files or folders in biscuit
• [x] editorconfig support for projects
• [x] sophisticated command palette (full list of static commands in src/biscuit/commands)

<img alt="preview" src="https://github.com/user-attachments/assets/1c44aab4-d8d1-4ba8-b92b-73c0c6dbfb00" />

license

biscuit uses the MIT License, see LICENSE file.