Concepts
Filesystem model
How Parlo turns APIs, drives, and repos into one path-based interface.
Parlo gives different remote systems the same shape: paths.
bash5 lines
1~/parlo/2 main/ # cloud drive3 github/ # API connection4 linear/ # API connection5 git/v8/v8/ # GitHub repoThe backend can be an API, object storage, or a remote repo. The interface stays familiar.
The core operations
| Operation | What it means in Parlo | Example |
|---|---|---|
ls | discover folders and resources | list issues, files, repos, query results |
cat / open | read content | issue markdown, PDF bytes, repo file |
editor save / parlo write | update or create | patch an issue, save notes, upload a file |
rm | delete, close, or clean up | remove a file, close a resource, clear cached query output |
parlo rg | search remotely | run ripgrep next to a cached repo |
Mounted mode
Use the mount when you want Finder, editors, terminals, media players, and local tools to see Parlo paths.
bash4 lines
1parlo mount2ls ~/parlo/3cat ~/parlo/linear/ENG-123.md4open ~/parlo/main/videos/demo.mp4Direct mode
Use direct CLI operations in CI, containers, and agent sandboxes where mounting is not available.
bash3 lines
1parlo ls github/issues/2parlo cat linear/ENG-123.md3parlo write linear/ENG-123.md --from ./updated.mdMarkdown API resources
Structured API objects are represented as markdown with frontmatter.
md10 lines
1---2id: ENG-1233status: In Progress4assignee: rob5labels: [bug, auth]6---7 8# Fix login redirect9 10Users should return to the original page after OAuth.This keeps API data readable for humans and easy for agents to edit with normal diffs.