Core concepts
How Flash works
Flash combines your hardware design, firmware, datasheets and project instructions to help you investigate, make changes and verify the result on the board.
What Flash knows
Your hardware design, firmware, FLASH.md, components and datasheets, plus the conversation you are in.
How the work gets done
A mode for how the agent works, and your approvals for what it may do.
What really happened
Builds, programming, debugger state and serial output from the board.
A shared foundation
Every task follows the same loop: prepare the project with /init, give a focused task, review what Flash asks to do and check the evidence. It works the same in Flash CLI, Flash IDE and VS Code.
Three independent controls shape that loop. The mode decides how the agent works, approvals decide what it may do without asking, and context is what it knows about your project. Each conversation keeps its own history on top of that context; see Sessions and context.
Understand the essentials
Run /init once per project: Flash analyses the firmware, tries a build, prepares connections and writes a guide into FLASH.md.
Hardware and firmware togetherDesign the board and write its firmware in one project, with an agent that works across both.
Agent modesChoose how Flash approaches a task: plan, implement, debug on hardware or learn.
Sessions and contextWhat belongs to the project, what belongs to a conversation and what the model sees.
Tool approvalsDecide what Flash can do without asking, and what always needs your confirmation.
Project memoryKeep project rules in FLASH.md, and choose whether Flash remembers things between conversations.
Hardware knowledgeHow Flash grounds its answers in your hardware: the catalog, datasheets, schematics and knowledge packs.
Tasks and verificationDefine the outcome, keep the work bounded and know what each result proves.
Models and AI accessHow Flash connects to AI on each plan, and how to choose a model.
Put it to work
Use the Debugging overview to inspect your board, or follow the tutorial to create a project, implement a sensor driver and check its readings.