Rama
Navigate your organization, starting with you
Overview
Rama draws an org chart from one YAML, JSON or CSV document and opens it on your own card: your
manager above you, your peers beside you, everyone's reports underneath, and the whole org as
rings one click away. Any key you add to a person shows up on their profile, and the same people
go to Floorplan as rooms or to Reparto as a sprint plan through a link, with nothing uploaded.
Live: rama.neorgon.com
Features
- Starts with you -- a
?me= link, the card you picked, or the email on your Neorgon account puts you at the centre; with none of them it opens at the top
- Walk the org -- click anyone, or use the arrow keys: up to the manager, down to the first report, across to peers; Back walks back
- Cards that move -- every card morphs from where it was to where it lands, and the line from the top down to the focused person carries a travelling pulse
- The whole org at once -- the overview draws divisions as wedges and levels as rings, coloured by division, team, track, employment, country, or local time (who is in working hours right now)
- You and them -- once you have a card, every profile says how you are connected: the closest manager you share and how many people sit between, drawn as a violet route in the overview
- Profiles with your own fields -- contact, local time, reporting line, teams with splits, expertise, and any extra key the document carries, labelled and typed through
fields:
- Contractors and open roles fold away -- they collapse into buckets under each manager and open in place
- One document, three tools -- hand a manager's org to Floorplan as rooms or their team to Reparto as a capacity plan, through the links those tools already read
- Search --
/ finds people by name, title, team, skill, city or email, accents and letters like ł and ß folded, the match highlighted
- Every way in -- the editor validates as you type, and YAML, JSON, CSV from an HR tool, Floorplan documents,
#d= links and ?src= URLs all go through the same gate
- Every way out -- YAML with comments kept, JSON, CSV with formula cells neutralised, Mermaid, a vCard per person, share links, and a ready prompt for Claude
The document
title: Lanternfish Systems
people:
- name: Hana Kobayashi
email: [email protected]
role: eng-director
- name: Jules Okafor
role: lead-engineer
manager: hana-kobayashi
location: Lagos, Nigeria
country: NG
tz: Africa/Lagos
pronouns: they/them # any extra key shows up on the profile
The full schema, the link contract and the handoff rules are in llms.txt; the sample org is examples/lanternfish.yaml.
Running locally
ES modules require an HTTP server (not file://):
make serve # http://localhost:8896
make test # Node tests over the pure core
Architecture
rama-site/
├── index.html # Shell, CSP, header kit contract, dialogs
├── llms.txt # The document schema, links and handoffs, for people and agents
├── examples/
│ └── lanternfish.yaml # The invented sample org
├── css/
│ ├── style.css # Template base: buttons, dialogs, toast
│ ├── chart.css # Chart, cards, wires, overview, transitions
│ └── panel.css # Stage bar, profile panel, palette, editor
├── js/
│ ├── app.js # Entry point
│ ├── schema.js # The org document: normalizeOrg, orgToDoc
│ ├── teams.js # Teams in Floorplan's group shape
│ ├── roles.js # Built-in role catalogue
│ ├── tree.js # Reporting tree index, focus view, search
│ ├── handoff.js # Floorplan and Reparto documents and links
│ ├── formats.js # CSV, Mermaid, vCard
│ ├── docio.js # Text in and out, #d=, ?src=
│ ├── state.js # Document, view state, preferences
│ ├── me.js # Who the visitor is
│ ├── nav.js # Moving between people, view transitions
│ ├── render*.js, wires.js, overview.js, panel.js, people.js
│ ├── search.js, editor.js, actions.js, boot.js, menus.js, events.js
│ └── neorgon-*.js # Vendored kits (header, footer, beacon, auth, dom, persist)
├── test/ # node --test over the pure modules
├── CNAME
├── Makefile
└── README.md
