Not a text editor

Firstly, Cosma is not a note-taking application. There is no text editor. So a direct comparison with fully fledged writing software like Obsidian has limited relevance.

Cosma only reads files, and generates a visualization of these files and their connections. It is not meant to replace your favorite writing tool but to work alongside it.

Why not make a text editor? Three reasons:

• It was first and foremost a pragmatic decision: we just didn’t have the means to develop a text editor. It is an extremely complex task, and convincing people to switch from their favorite tools is an uphill battle we didn’t want to fight.
• The decision was also a matter of preference: we like software that pair with a writing tool of our choice, allowing us to switch between different text editors depending on the situation. The presentation app Deckset is a good example of this: write in any text editor, design and present the slides with the app.
• And it was also a strategic choice: in the space of non-linear documentation, there are very few visualization-only tools. This means less competition with other programs for the users’ attention.

An app within an app

The other uncommon choice we made is about the architecture of Cosma.

As a user, you install a program called cosma, which has a command-line interface. You then use this program to generate an HTML file, the cosmoscope, which behaves like a self-contained application, with text, menus and buttons. The cosmoscope is where Cosma’s usefulness resides. It is the app within the app.

% cosma modelize --project my-notes  
[Cosma v.2.0.0] My Notes my-notes.yml
Building cosmoscope… (source type: csv)
Cosmoscope generated (128 records)

For most visualization software, functionality exists within an installable program, and exports are either static or with very limited interactivity. For Cosma, we wanted to have just as much functionality in the exports as within the app. We were influenced by digital notebooks, publishing software and web applications in general, where users have access to data but also functionality. So we designed Cosma around an app-like export, generated by a very light cosma command-line program.

The cosmoscope can be used on its own. It doesn’t require the cosma program, just a web browser. It doesn’t require an Internet connection. It can be shared just as any other file attachment in email, chat, file transfer programs, etc. Thus, whether you are the person who creates it or the one who consults it, you have the same heuristic capacities.