Your First Node
Creating and understanding nodes in RA-H
What is a Node?
In RA-H, a node is the fundamental unit of knowledge. Unlike files in a folder system, nodes are:
- Flexible: Can contain any type of content
- Connected: Automatically linked to related nodes
- Evolving: Gain dimensions and connections over time
Creating Your First Node
Using the UI
- Click [+ New Node] in the Nodes panel
- Enter a title in the Focus panel
- Add your content (markdown supported)
- Press
Cmd+S
or click Save
Use the UI during the beta. API/CLI examples will return later.
Node Structure
Every node contains:
interface Node {
id: string // unique identifier
title: string // human-readable title
content: string // markdown content
dimensions: string[] // emergent tags
embedding: number[] // vector for similarity
metadata: {
created: Date
modified: Date
source?: string // youtube, website, etc
author?: string
}
}
Content Types
Nodes can contain various content types:
Text Notes
# Meeting Notes
- Discussed emergent organization
- Non-prescriptive approaches win
Code Snippets
```python
def process_node(node):
return embed(node.content)
```
Extracted Content
[Extracted from: https://example.com]
Article content here...
Automatic Features
When you create a node, RA-H automatically:
- Generates embeddings for semantic search
- Extracts dimensions from content
- Creates edges to related nodes
- Indexes for search across all helpers
Tips
- Keep titles short and specific
- Write naturally; dimensions and connections will emerge
Best Practices
Don't overthink structure - Let dimensions emerge naturally from your content rather than pre-defining categories.
- Write naturally: Don't force keywords
- Link freely: Mention other concepts naturally
- Trust emergence: Organization will develop over time
- Use helpers: Let AI assistants help you explore connections