Aretext is designed to integrate seamlessly with a terminal-based workflow. This strongly influences aretext's approach to managing files:
It delegates window management to your terminal multiplexer or emulator. Each instance of aretext opens a single document at a time; to edit multiple documents simultaneously, you can use tmux to run multiple instances of aretext in the same terminal.
It provides no commands within the editor to move, rename, create files, or change the working directory. You can use your shell (outside the editor) for these functions.
It automatically reloads files that change on disk (unless there are unsaved changes). For example, if you run a code formatting tool that changes a file, aretext will automatically reload it.
Aretext currently supports only UTF-8 encoded documents.
Aretext has built-in fuzzy search for files. This allows you to quickly find and open a file without leaving the editor:
Aretext always searches within the current working directory.
To have aretext open a document immediately, pass the path as a positional argument like this:
If you do not provide a path argument, aretext will start an empty document called something like "untitled-1621625423.txt" (the number is a Unix timestamp). You can either insert text and save this document (useful for writing quick notes) or use fuzzy file search to open another document.
Aretext remembers which documents you have opened in the editor. To return to the previous document:
Once you have opened a previous document, you can return to next document using the "open next document" menu command.
Aretext will warn you if a command would discard unsaved changes or overwrite changes made by another program to the file on disk. You must then decide to either force-save, force-reload, or force-quit.
To search for a term in multiple files, you can create a custom menu command that calls
grep. See Customization for instructions.