AIC Notes
English · Українська
AIC Notes is a Markdown editor for VS Code desktop and the Web. It edits every *.md document with the AIC
preview-first surface and keeps one note per project, <folder>/<folder name>.note.md, whose
page for the active file is shown in the Secondary Side Bar.
The extension adds no Standard Notes sign-in, account requests or note synchronization.
File operations use the filesystem provider selected in VS Code. Copy blocks manually when needed.
The same extension also runs in VS Code for the Web (vscode.dev and
github.dev). Open a folder or repository, then open a Markdown file with
AIC Markdown. Markdown editing and linked notes use the
workspace's filesystem provider and VS Code's Save/Undo. Read-only repositories
remain readable; saving notes or setting up agent instructions requires a writable
provider. AIC does not synchronize the workspace; any repository or cloud writes
follow the provider you selected in VS Code.
AIC uses plain Markdown without an app password or encrypted workspace format.
The extension does not open or convert .aicnotes files; existing files are left
untouched. Secret fields remain visually masked, but their Markdown source is plain
text. Use your filesystem or device controls when file encryption is required.
Prepared release 62.3.1 uses shared editor core 8.1.0 in the main editor and Linked Note.
A --- line after a blank line splits a note into page cards, and --- <path>
binds a page to a file by its project-relative path, matched exactly as written. Linked Note shows the page of the project note bound
to the active file and keeps edits and Undo inside that page. Sidecar notes, pin,
Trash and the Current, Shared and Global tabs are removed; existing sidecar *.note.md
files stay ordinary Markdown. Slash templates follow DDK, and /aic inserts an
AIC block. Store availability is verified separately.
The PWA edits one chosen Markdown note file directly on disk.
In VS Code the main editor shows the opened document and Linked Note shows the
active file's note; mobile navigation gives the editor more space. Optional on-device AI and the shared DDK-based writing guide help
revise documents. VS Code refuses to save an existing document after its file
has been deleted. Synchronization remains under the user's control.
Empty editable secret (*|) parts offer Generate password at every panel
width, regardless of their label. Options wrap to fit narrow screens. Generation
stays local, never overwrites filled values, and is unavailable in read-only notes.
Icon-only copy buttons briefly show a checkmark on success or a cross on failure,
with an accessible status announcement and a stable action name. Larger section
headings, distinct neutral group backgrounds and subtle alternating gray rows
make records easier to scan.
Labels, email addresses and logins use their natural width. A complete value moves
to the next line before its text wraps; only text wider than the full available
line breaks internally. Passwords use compact lock-only copy buttons, while
short card values and TOTP codes remain readable. The + menu follows the last
value, and subtle separators distinguish records. Touch controls retain 44 px
targets.
Leaving an AIC block's source edit, or switching the whole note from source to
preview, sorts rows by label within each section using natural, case-insensitive
order. Unlabelled rows remain in their original order at the end. Section order,
value order and exact authored values are preserved. Opening a preview, copying
and manual reordering do not trigger sorting.
AIC fields and source mode
The main editor and linked-note sidebar consume the same bounded aic document
renderer as Standard Notes. Each separator types the next value: | text, *|
secret, #| authenticator seed, _| card, 1| unused one-time value and 0|
used one-time value. A label before the first separator is optional, and a row can
combine differently typed parts:
# Account
Login | person@example.test
Password *| synthetic-secret
Card _| 4111111111111111 | 12/30 *| 123
Recovery codes 1| code-one 0| already-used
Blank, Card and One-time codes are presets made from these parts, not additional
types. Copying an unused 1| value marks it 0|; activating a used value restores
1| without copying, and only used values expose removal. Field inserts a typed
part in the current row, Row inserts below it and Section inserts after the current
section. Mutations use the existing VS Code save/undo contract.
The single Show Markdown source / Show preview icon toggles AIC previews in
place without resetting Undo. Returning to preview applies the AIC row sorting
described above through the normal document-change lifecycle. The mode is temporary
for the current note, and raw Markdown can expose visually masked values. The local
? guide is shared with the other hosts and works without note, storage or
network access.
Legacy YAML Properties, colon fields and prior Security forms remain exact raw
Markdown for manual repair. They are not rendered, stamped, reordered or migrated
automatically. Filesystem timestamps may still exist as VS Code metadata, but the
editor and linked-note header do not display created/updated dates.
Security field actions
Authenticator JSON conversion
Open an original Authenticator JSON array in AIC Markdown, or select the complete array
inside a document. Convert and save security blocks appears for recognized records with
service, account and secret strings. The shared converter creates one aic
block with independent sections: Service/Account/Notes are visible; TOTP, Password and extra string fields
are hidden. Safe service URLs also gain a separate Open-capable URL field.
Standalone --- separates sections; headings are optional. Overflow moves to further
blocks without dropping data. The preview shows limits (16 sections, 64 fields per section,
65,536 text units per block, 16,384 per field including all pipe parts and escapes)
and disables additions that would exceed them.
New block stays available. Group blocks by purpose, for example services, banks, web or
social networks. Existing notes are never automatically repartitioned.
Conversion is one explicit edit, undoable with Ctrl/Cmd+Z, saved through the same parent
manager as other security actions. It works in the main editor and linked-note sidebar. It does not scan the account,
read the clipboard, migrate native note types or synchronize notes. Invalid records,
duplicate keys or unsupported values reject the whole array without partial edits.
The maximum is 256 records / 1 MiB UTF-8 source. Credential strings are never guessed,
trimmed or repaired; use valid original JSON rather than Markdown-escaped credential text.
Copy, Paste and generation
Tap/click a security field label to copy the label itself (for example a username), or its
value to copy the stored value. “Copied” briefly overlays the pressed target after success.
Tab navigates; Enter/Space activates. The field icon is Paste,
present only for empty fields, alongside Delete empty field. Filled fields have neither button.
There is no Replace action.
Whole-block Copy remains in the header; filled fields can be copied, but changing their
values requires source Edit. URL Open and TOTP controls are unchanged. Security preview
mutations save immediately through the parent manager. Ordinary typing saves on Ctrl/Cmd+S,
Save or leaving the editing surface, not on each input. The saved state requires acknowledgement.
Paste directly reads the latest text using VS Code's
native clipboard API,
through a bounded, identity-bound request. There is no AIC dialog, intermediate input or
history picker on success. Hidden values are never previewed; empty clipboard text makes
no change. Only denied/unavailable/timed-out access offers inline masked paste-only capture.
Standard Notes uses the browser API,
which may show its own permission prompt. AIC cannot bypass platform clipboard permissions
and does not read or store clipboard history.
Every empty editable secret (*|) part offers Generate password, regardless
of its label or viewport width. Options wrap in narrow panels; read-only notes
omit the control. Default: 24 characters,
uppercase/lowercase/numbers/symbols enabled; length 8–128 and groups are configurable.
Each enabled group occurs at least once. No existing value is overwritten or automatically
copied/revealed. Clear through source Edit and return to preview to generate again.
TOTP and other non-secret part types do not offer password generation.
Both products use the same local Web Crypto
generator and UI. Options are inspired by 1Password,
not the same implementation. Markdown, exports and clipboard values remain plaintext.
Recovery codes and titles
Add Recovery codes adds a hidden batch field. Paste one code per line; empty lines are
ignored, exact spaces and duplicate codes retained. Codes remain masked and copy individually.
The reversible Used checkbox does not delete a code; copying is not proof that a service
accepted it. Whole-block Copy preserves codes and their used flags in another document.
Without an independent # card title, the first section title replaces the card name,
without a duplicate heading row. Use ## Account name for a custom name or bare ##
for the default Security header.
The independent AIC for Standard Notes plugin shares
editor-core 8.1.0 but is a separate product. Current release targets are AIC Notes
62.3.1 and AIC for Standard Notes 53.6.3. This page describes the release contract;
published artifacts are verified separately by the release workflow. Transfer content manually
between the two applications; VS Code has no Standard Notes account integration.
Coordinated release — 56.4.5
The new local-file PWA opens Markdown files and folders, keeps device-local copies,
and offers optional encrypted exports. Current, Shared and Global tabs focus on
one note at a time across supported hosts; mobile navigation gives the editor
more space. Optional on-device AI and the shared DDK-based writing guide help
revise documents. Folder imports count only Markdown files and support progress
and cancellation. VS Code refuses to save an existing document after its file
has been deleted. Synchronization remains under the user's control.
See the bilingual installation guide.
Coordinated release — 53.0.1
Empty password fields show the generator at every width, with options that wrap
inside narrow panels. Existing values and read-only notes cannot be overwritten.
Standard Notes AIC 45.0.1 and browser 0.9.1 share core 7.3.1. See the
bilingual installation guide.
Coordinated release — 52.1.0
AIC rows use natural-width labels and values, move whole values onto the next
line, and show passwords as compact lock-only copy targets. Leaving source edit
sorts rows by label within each section. Standard Notes AIC 44.1.0 and browser
0.9.0 use the same shared core 7.3.0. See the
bilingual installation guide.
Coordinated release — 51.1.0
Credential rows remain one connected responsive layout in VS Code, Standard
Notes and the experimental browser. Labels size to their text, flexible values
receive the remaining width, protected copy is a compact lock-and-six-dot
target, and one trailing + menu owns Field, Row and Section creation. A quiet
divider separates neighboring records. Standard Notes AIC 43.1.0 and browser
0.8.0 use the same shared core 7.2.0. See the
bilingual installation guide.
Coordinated release — 49.1.2
Unpinning Linked Note immediately resumes following the active main file as one
navigation operation, without a window reload. Product and release documentation
is available in English and Ukrainian, and localized documents are included in
the verified VSIX. Standard Notes AIC 41.1.2 and experimental browser 0.6.1 pair
with this patch on shared core 7.0.0. See the
bilingual installation guide.
Coordinated release — 49.1.1
Mermaid is edited as Markdown source with a live preview. Copy and one shared
Edit icon appear in the preview, while zoom works only there. The visual
builder, drag-and-drop and rotation controls are removed. Standard Notes AIC
41.1.1 and experimental browser 0.6.0 use the same shared core 7.0.0.
The single installation guide
covers all three products.
Coordinated release — 48.0.1
Information (>), warning (!>) and error (!>>) quote blocks now have
separate accents, subtle backgrounds and more space around them. Quoted and
italic text is smaller. >>> … <<< still means details. A code fence remains
editable while its language is typed; a completed block previews after the
caret leaves its delimiters. Standard Notes AIC 40.0.1 and experimental
browser 0.5.2 use the same shared core 6.2.2. The single installation guide
covers all three products.
Coordinated release — 47.0.1
Markdown headings, quotes and lists have more space between them in both editor
surfaces. A thematic break appears as a centered 50–100 px line with space
above and below. Its row retains the same height when the caret reveals the
raw ---; authored Markdown is unchanged. Standard Notes AIC 39.0.1 and
experimental browser 0.5.1 use the same shared core 6.2.1.
Coordinated release — 46.1.1
New AIC blocks start with an unlabeled text row for an email or username. The
Account row preset is gone; Password and TOTP are separate optional fields. In
narrow main and Linked Note panels, each field label and its values wrap together
into readable columns. Password generation controls are hidden at viewport widths
of 600 px or less. Existing authored notes retain their content. Standard Notes
AIC 38.1.1 and experimental browser 0.5.0 use the same shared core 6.2.0.
Coordinated release — 45.1.0
This release adds Copy section in each AIC section header in the main editor
and Linked Note. It copies a standalone fenced aic block containing only that
section, including masked and filter-hidden rows, without the card title or sibling
sections. The shared serializer preserves logical labels, exact value text and
typed parts; authored whitespace and quoting may be normalized. Copy works in
read-only views, guards stale controls and does not edit or save the note.
Core 6.1.0 adds this action without changing the typed-pipe grammar. The separate
browser 0.4.0 release adds Global Shared inside its encrypted browser-profile vault;
it is not a VS Code feature or a connection between applications. The proposed
generated-key and VS Code global.aic encryption architecture remains unimplemented.
The extension remains local-only, with no account connection or synchronization.
Release assets require separate verification; no Standard Notes PWA crash fix is claimed.
The prior 44.4.7 release retired the native Notes & Documents tree, adopted typed
aic values and the local guide, aligned compact field actions and kept one source
toggle in the main footer. Core 6.0.0 introduced the breaking grammar: colon fields
and YAML Properties remain exact raw text for manual repair, without automatic
stamping or migration. Typed values use |, *|, #|, _|, 1|, and 0|.
The prior 43.0.1 release fixed the compact inline card row and introduced the additive,
partially adopted shared component IDs, BEM helpers and geometry tokens.
The prior 42.0.3 release fixed compact generic pipe fields and repeated parsing,
viewport-bounded Add menus, and caret visibility. Its additive previewOnly API
supported the separate browser host without adding a VS Code feature.
The previous 41.1.1 release added quoted value slots to Security and opt-in v2 Properties,
and fixed literal-pipe handling outside the exact spaced separator. Historical Security
formats require manual source repair; no notes are automatically rewritten.
The shared AIC templates insert the same aic Markdown block
as the Standard Notes plugin. A standalone --- starts another section;
## Main optionally titles one. Each value starts with |, *|, #|, _|,
1|, or 0| for text, secret, TOTP, card, unused one-time, or used one-time
data. Add Field targets the current row, Add Row inserts below, and Add Section
inserts after the current section. Blank/Card/One-time codes are presets made
from those value types; an unlabeled text row can hold an email or another identifier.
Email and URL remain text. Edit opens raw Markdown.
Preview can copy individual values, one-time codes and the complete fenced block, or open a safe
HTTP(S) URL. Save, Ctrl/Cmd+S and leaving the surface share the same persistence manager. This is
visual masking only: raw Markdown, other editors, local files, exports and
copied blocks still contain plaintext secrets. There is no QR import UI. It
does not enable Standard Notes synchronization or convert native Authenticator
notes.
Both editors share task controls, details parsing, code-language aliases and the bounded
Mermaid render queue. Nested inputs own their selection; Ctrl/Cmd+A inside a diagram field
does not select the surrounding Markdown document.
Save revalidates document identity,
revision, editing ownership and the originating view after asynchronous work. Provider-owned
scopes retire subscriptions and pending requests when a surface closes.
The File Context sphere and the native Notes & Documents tree have been removed.
Linked Note remains; existing Markdown and *.note.md files are not migrated or deleted.
Editor features — shared editor core 6.2.2
This release target pairs with AIC for Standard Notes 40.0.1. The release gate must
byte-verify their shared core and run automated tests and production builds. Prior Windows
browser checks cover the shared controls but do not replace final package verification;
Linux desktop smoke checks are not implied.
/section, /glossary, /bibliography, /high-level-design, /detailed-view,
/error-handling, /test-cases and /open-question insert a heading, one italic question and
an answer in the simplest fitting format, at the heading level below the nearest heading above.
There are no page templates. The same catalog works in AIC and native Markdown, including .note.md.
/list, /list-numbered, /checklist and /table insert an unordered list, ordered list,
bare checkbox list and simple table. /checkbox and /tasklist also find /checklist.
/aic inserts an AIC block (fields, secrets, codes); /security, /password, /2fa,
/fields, /properties and /credentials also find it.
- Opening the project note in the main editor shows the whole note as page cards, each with
Open target. Persisted legacy note associations resolve to the main editor without changing
user settings. Unsaved sidebar drafts are preserved when the active file changes.
- The note pane starts directly at its content, without a duplicate name, folder,
created/updated date or save-status header. Saved notes are neutral; unsaved notes have a soft amber tint and a small
change marker; placeholders are gray. Save, Ctrl/Cmd+S and leaving the surface commit the draft.
- In the AIC editor, Mermaid is edited as raw Markdown with a live preview below the fence.
/mermaid finds /flowchart; native VS Code text editors offer snippets but not the embedded preview.
- A missing project note starts empty. Existing notes and
.aic/templates/*.md files are left
exactly as they are and are no longer read. No generated file/date Properties are added.
- Insert
/flowchart, /sequence or /state-diagram in AIC Markdown. The Mermaid
preview has Copy and one Edit button matching other code blocks. Edit reveals the
source and a live preview. Diagrams fit the available width with their full content height,
without internal scrollbars or zoom controls. There is no visual
builder, drag-and-drop editing or rotation control. Ctrl/Cmd+S saves through the host;
editing does not rewrite the source automatically.
- Enter preserves indentation and list continuation; Tab/Shift+Tab indent/outdent unless a
snippet field is active. Mermaid source uses the same Markdown editor behavior.
- In AIC Markdown (documents and notes), Ctrl/Cmd+Alt+1…6 toggles heading levels;
Ctrl/Cmd+Shift+7/8/9 toggles numbered, bullet and checkbox lists. Formatting does not save.
- Agentic Notes has a tested shared scope/section core, not an active universal agent adapter.
It selects existing current/ancestor notes, excludes sibling memory and private notes, and
proposes edits confined to a marked Agentic Notes section. A live-document write bridge and
cross-client integration are still required; no standalone disk writer is enabled.
Automatic
drill-down/cross-scale links and visual diagram authoring are not implemented. Shared popup/session and preview-navigation stability changes are included;
this section does not assert that all clients or operating systems have completed final smoke tests.
Install
AIC Notes is available in VS Code Marketplace
as ldzyha.aic-notes.
code --install-extension ldzyha.aic-notes
Marketplace installations follow VS Code's auto-update settings. If you installed
an earlier VSIX, enable Auto Update for AIC Notes in Extensions to receive
Marketplace updates. VS Code update behavior.
Automatic publication of future GitHub releases is prepared but still needs the
repository's VSCE_PAT secret and a successful authenticated run. Setup, retry
and the required Entra migration are documented in
Marketplace publishing.
code-server uses Open VSX; this Marketplace pipeline does not publish there.
Use the manual GitHub VSIX until that separate distribution is set up.
The unified release page
has installation steps for VS Code, Standard Notes and Chrome/Edge in one place.
For manual installation, download aic-notes-62.3.1.vsix and its
aic-notes-62.3.1.vsix.sha256 checksum from AIC Notes releases.
The VSIX is universal: use the same file on Windows, Linux, macOS, and code-server. Do not
substitute an older release's checksum for this candidate.
Windows PowerShell:
(Get-FileHash .\aic-notes-62.3.1.vsix -Algorithm SHA256).Hash.ToLower()
Get-Content .\aic-notes-62.3.1.vsix.sha256
code --install-extension .\aic-notes-62.3.1.vsix --force
Linux, macOS, or code-server:
sha256sum -c aic-notes-62.3.1.vsix.sha256
code --install-extension ./aic-notes-62.3.1.vsix --force
# or: code-server --install-extension ./aic-notes-62.3.1.vsix --force
Reload the VS Code window after installation. Local editing and the bundled agent instructions require no additional executable.
Local note model
*.md is a normal local Markdown document shown in the full AIC Markdown editor.
- Each project (workspace folder) has one note at its root, named after the folder:
<folder>/<folder name>.note.md, for example my app/my app.note.md. With several workspace
folders, the active file's folder chooses the note.
- Linked Note shows only the page of the project note bound to the active file. A file without a
page shows an empty card.
- Viewing a file never creates or changes the project note. The first typed text appends the page,
and the first save creates a missing project note.
- When the project note itself, a non-file tab or a file outside the workspace is active, Linked
Note shows the whole note as cards.
- When the project note changes while Linked Note has unsaved text, the draft is not replaced. Saving
writes the draft's pages into the changed note if those pages did not change there; otherwise
nothing is written, the draft stays, and the footer offers "Discard my changes and reload",
which asks for confirmation.
- A project note of that name from versions up to 60.x is used as is; its text stays the first
page and nothing in it is rewritten until you edit. Other
*.note.md files remain ordinary
Markdown files and are not followed.
- Version 61.6.5 kept the note in
<folder>/aic.md. That file is no longer followed and is never
changed or deleted; if you used it, copy its pages into the project note.
Note pages
A note is a notebook. A line that is exactly ---, first in the body or after a
blank line and outside fenced code and leading frontmatter, starts a new page;
--- src/app/editor.ts binds that page to exactly that project-relative file (written
with /, without a leading ./ or /).
The note stays one file. Each page is a card whose header names the target;
Open target opens that file in the main editor, or an http(s) target in the browser,
and is the only card action. Folders and paths outside the project are refused.
A bound line starts its page even inside an unclosed code fence, so a fence
never runs past its page.
An unsaved note stays visible until it is saved: changing the active file only
moves the page focus and keeps the draft. Undo stays within the focused page.
Saving and deleting
Ctrl/Cmd+S, Save and leaving the editing surface persist Secondary notes. Security preview
mutations save immediately; ordinary typing does not save on each input. Wait for the acknowledged
saved state before terminating the app; an interrupted process cannot guarantee completion.
The pane is softly amber while unsaved, neutral after a successful local save, and gray for an
unmaterialized placeholder. Ordinary Markdown documents use the same explicit VS Code save action.
The extension has no delete action: it never deletes, moves or renames a note file.
When upgrading from a synchronization-capable release, AIC Notes removes only its retired local
session key, encrypted session directory, and workspace bindings. Existing *.md and *.note.md
files are preserved unchanged. A separate exact-key cleanup removes the former VS Code
Standard Notes sign-in session from SecretStorage. Neither cleanup makes a remote request.
Editor interactions
The document remains exact Markdown source. Preview structures disclose only the source being
edited; there is no document-wide preview/edit mode switch.
On an otherwise empty Markdown line, type / to open the shared template catalog. It works in the
AIC Markdown editor, VS Code's native Markdown editor, unsaved Markdown documents, and contextual
.note.md notes; every adapter consumes the same catalog, in the same order for empty and existing documents.
Choose a result, then use Tab to move through its highlighted questions and replace the example
answers. The compact menu separates Blocks, Sections and Diagrams. Completion stays inactive inside fenced/inline code
and in read-only documents.
- Text, headings, lists, tasks, quotes, emphasis, and fenced languages edit directly.
Ctrl/Cmd+A selects the full Markdown source, including from preview mode. Dragging over preview
text keeps a stable native selection for copying; Edit reveals that block's Markdown source.
- Links open on the main click. Their Open, Copy, and Edit icon controls remain visible without a
hover-only gap.
- Code blocks render as preview cards with Copy and Edit controls.
- Mermaid diagrams render in place with Copy, Edit, natural sizing and full content height.
They shrink to fit narrow views; the canvas spans the available width without internal scrolling.
- Tables use content-sized columns, word-level wrapping, a dedicated horizontal scroller, Copy,
row/column insertion, and drag reordering. A transient popover textarea appears only for the
selected cell.
- One bounded fenced
aic document owns structured fields. Each value begins with
|, *|, #|, or _| to identify that value as text,
secret, TOTP, or card data; a field can mix independently typed values. Click a
label or value to copy it; supported empty values expose their local actions.
1| marks an unused one-time value and 0| its used state; successful Copy
changes 1| to 0|, while reactivation does not copy.
Masking is visual only: source Markdown and whole-block Copy can expose plaintext.
Legacy YAML Properties remain exact raw Markdown for manual editing and are never
interpreted, stamped, cleaned up, or migrated automatically.
- A read-only dependency tree appears before custom note properties when frontmatter exists. It
is derived from actual workspace notes and shows project, note-bearing parents, current target,
children, and nearby notes; it is not stored in the Markdown and cannot be edited. Project and
current-target placeholders remain navigable; absent ancestor folders are omitted.
- AIC details blocks preserve accordion state, task-checkbox interaction, source comments, and
linked targets.
All action icons use CSS SVG masks. The DOM does not depend on inline SVG support from a host
renderer.
Commands
- AIC Notes: Open Note Page for Current File (
Ctrl/Cmd+Alt+N)
- AIC Notes: Use Native Editor for Plain Markdown
- AIC Notes: Enable AIC Agent Workflow / Sync Agent Instructions
- AIC Notes: Copy Agent Instructions
Optional AIC agent workflow
AIC Notes includes its agent instructions. No separate AIC executable, server,
account or configuration folder is required. Copy Agent Instructions copies
the bundled Markdown for any coding agent, including in an untrusted workspace.
The local ? guide also exposes that same selectable text.
The guide (version 4) points agents to the project note
<folder name>.note.md as read-only, owner-authored context: its leading text
and the page bound to the file being changed. aic context resolve --path <file>
returns the same context for aic users; other agents read the note directly.
Agents never create the note or add pages. Older per-file and per-folder
*.note.md files are read if present and are not created. Note content is
evidence under the active project instructions, not authority to run commands.
In a trusted workspace, Enable AIC Agent Workflow writes an immutable copy
under .vscode/aic-agent-<content-hash>.md and a .vscode/aic-agent.json marker
pointing to it. Choose Copy handoff to give that file path to your agent.
Sync Agent Instructions refreshes this local handoff explicitly; it no longer
runs global AIC rule synchronization. The file name comes from the guide's hash,
so when an update changes the guide, the next Enable or Sync writes a new
instruction file and points the marker at it; the previous file is left in place.
Existing schema-1 markers migrate when you run either command. Edited
instruction files and unrelated markers are preserved.
Installation, upgrades and workspace trust changes do not run a CLI or modify
workspace/global instructions. Existing AGENTS.md and provider settings are
unchanged. Agents must receive the instructions through the copied text or file
handoff; the extension does not claim they discover it automatically.
Development and release
npm ci
npm test
npm run build
npm run release:gate
npm run release:gate builds one aic-notes-<version>.vsix, creates its SHA-256 sidecar, and
inspects the archive. The gate rejects native/WASM helpers, platform targeting, development source,
retired synchronization commands/settings, incomplete editor controls, secrets, and checksum
mismatches.
Release versions use R.F.B: release sequence, shipped feature outcomes, and fixed-bug outcomes.
The coordinated version 56.4.5 records sequence 56, four feature outcomes and five fixed-bug
outcomes; it is not a publication marker by itself.
See FUNCTIONAL_INDEX.md for the release-critical behavior map and
PROVENANCE.md for the shared-core snapshot identity.