Command reference

The commands below are what the CLI exposes for your editor's skills and your CI jobs to call. Most of the time the agent in your editor or your CI workflow handles these for you. It's useful to know what's available when you're building a custom skill or workflow.

Read a file

Print the contents of a file:

buron file read /wiki/company.md

Write a file

Write content from another source:

echo "# Q2 recap" | buron file write /wiki/analyses/q2-recap.md

Or from a local file:

buron file write /ads/google/reports/today.md --from-file /tmp/report.md

If the file already exists, this overwrites it. To add to a file instead, use buron file append with the same syntax.

Find a file

Search by name pattern:

buron file glob "/wiki/**/*.md"

Or search by content inside a folder:

buron file grep "Loopio" --directory /wiki/entities/

Edit a file

For one-off text changes, buron file replace is faster than rewriting the whole file:

buron file replace /wiki/team.md -o "old text" -n "new text"

Move or delete a file

Rename or move:

buron file move /wiki/old.md /wiki/new.md

Delete:

buron file delete /wiki/old.md

Deletes can't be undone. To be safe, move things you're unsure about into an archive folder instead.

Update editor skills

Pull in the latest versions of the slash commands installed by buron link:

buron skills update

It's a good idea to run this after major Buron releases.