Plot
Create, configure, view, and share plots from the command line.
AI-assisted, human-approvednovem uses AI to review and keep our documentation up to date.
Install and authenticate the novem CLI before using these commands.
Plots are selected with the -p flag. On its own, -p lists all of your plots;
with a name it selects that plot for the operations described below.
# list all of your plots
novem -p
# select a single plot to operate on
novem -p my_plot
Creating a plot
Add -C to create the plot if it doesn't already exist. The --type flag is a
shorthand for writing config/type, and sets the chart type.
# create a new plot and set it to a bar chart
novem -p my_plot -C --type bar
Adding data
The data lives at the plot's data path. Write to any path with -w — the
value can be supplied inline, read from a file with @filename, or piped on
stdin.
# from a file
novem -p my_plot -w data @data.csv
# or piped on stdin
cat data.csv | novem -p my_plot -w data
Setting title, caption and other config
Everything under config/ is set the same way, with -w and the relative path.
novem -p my_plot -w config/title "Quarterly revenue"
novem -p my_plot -w config/caption "Source: internal finance data"
For a subtitle, write two newline-separated lines. The title reference covers per-line styling and alignment:
novem -p my_plot -w config/title $'Quarterly revenue tx:18\nUnaudited tx:12'
To edit a longer value interactively, -e opens the path in $EDITOR and saves
on exit:
novem -p my_plot -e config/caption
Viewing a plot
Read any path back with -r. The url path returns the shareable link, and
-x is a shorthand for a terminal-friendly render (identical to
-r files/plot.ansi).
# print the shareable url
novem -p my_plot -r url
# preview the plot directly in your terminal
novem -p my_plot -x
Sharing
Shares are managed with -s. A bare -s lists the current shares; combine it
with -C to add a share and -D to remove one.
# share publicly
novem -p my_plot -C -s public
# list current shares
novem -p my_plot -s
# stop sharing publicly
novem -p my_plot -D -s public
Tags
Select a tag with -t (for example fav, pin, hide, wip, archived, a
+usertag or a =categorytag); a bare -t lists the plot's current tags.
# mark a plot as a favourite
novem -p my_plot -t fav
# feature this plot on your profile feed (up to four newest pins)
novem -p my_plot -t pin
# keep this plot out of lists, search, discovery and feeds
novem -p my_plot -t hide
# list the plot's tags
novem -p my_plot -t
Deleting a plot
novem -p my_plot -D