mujarrad-cli
Advanced tools
⚠️ ALPHA: Obsidian Knowledge Graph Integration CLI - Sync your Obsidian vaults with Mujarrad workspaces
⚠️ ALPHA SOFTWARE - This CLI is currently in alpha development. Features may change without notice, and breaking changes may occur between versions. Use at your own risk. See Version Status for details.
╔═══╗
║▓▓▓║ ╔═══╗
║▓▓▓║═════╣▓▓▓║
╚═══╝ ║▓▓▓║═══╗
╚═══╝ ║
║
╚═══╝
███╗ ███╗██╗ ██╗ ██╗ █████╗ ██████╗ ██████╗ █████╗ ██████╗
████╗ ████║██║ ██║ ██║██╔══██╗██╔══██╗██╔══██╗██╔══██╗██╔══██╗
██╔████╔██║██║ ██║ ██║███████║██████╔╝██████╔╝███████║██║ ██║
██║╚██╔╝██║██║ ██║██ ██║██╔══██║██╔══██╗██╔══██╗██╔══██║██║ ██║
██║ ╚═╝ ██║╚██████╔╝╚█████╔╝██║ ██║██║ ██║██║ ██║██║ ██║██████╔╝
╚═╝ ╚═╝ ╚═════╝ ╚════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝
╔═══════════════════════════════════════════════════════════════════╗
║ DATA UNLOCKD ║
╚═══════════════════════════════════════════════════════════════════╝
The Ultimate Abstraction Application
Unlock, Distill, and Amplify Your Data
Current Version: 1.2.0-alpha.2 (Alpha)
This CLI is in active alpha development. While core functionality is stable and tested, you should expect:
What's Stable:
@mujarrad/sdk) — alphaWhat's Being Refined:
Reporting Issues: Please report bugs and feedback at GitHub Issues. Your feedback helps us improve!
Mujarrad is the data superpower that transforms complexity into clarity. We don't just manage data—we unlock its potential, distill its essence, and amplify its impact.
In a world drowning in noise, chaos, and complexity, Mujarrad reveals the signal. We architect intelligent abstractions that transform overwhelming data landscapes into elegant, composable building blocks.
We harness complexity. We deliver simplicity.
🔓 UNLOCK
|
🎯 DISTILL
|
⚡ AMPLIFY
|
🧩 Abstraction as Power We compose data into polymorphic, flexible blocks—adaptive components that evolve with your needs.
🏗️ Architecture as Art Every layer is engineered with elegance. Our framework provides the foundation for scalable, intelligent systems.
⚙️ Intelligence in Action Data-driven, smart, sophisticated operations that master complexity and deliver results.
🌊 Fluid by Design Dynamic, elastic, agile structures that embrace change and flow with your requirements.
Transform your Obsidian knowledge base into a powerful, structured graph. Upload notes, folders, and canvases while preserving every visual detail and connection.
Real-time synchronization keeps your data flowing seamlessly. Work offline or online—Mujarrad adapts to your workflow.
Pixel-perfect accuracy maintains your creative layouts. Every position, color, and connection is preserved with precision.
Accelerate project creation with pre-built frameworks. Business Model Canvas, SWOT Analysis, and more—all ready to activate.
Encrypted credentials, intelligent access control, secure by design. Your data's foundation is solid.
Track every change, master your history. Git integration provides complete insight into your data's evolution.
Batch processing, efficient algorithms, optimized operations. Speed meets sophistication.
npm install -g mujarrad-cli
npx mujarrad-cli [command]
mujarrad auth login
Unlock your workspace with secure credentials.
mujarrad upload ./my-vault --workspace my-workspace
Distill your Obsidian vault into structured, intelligent data.
mujarrad clone ./new-vault --workspace my-workspace
Realize your knowledge graph anywhere, anytime.
mujarrad sync ./my-vault --watch
Embrace continuous synchronization—data that adapts and evolves.
Use Mujarrad as a graph-based backend for your apps — like Firebase/Supabase, but graph-native.
npm install -g mujarrad-cli
mujarrad auth login
mujarrad sdk init my-app
cd my-app && npm install
// src/schema.ts
import { defineSchema } from '@mujarrad/sdk';
export const schema = defineSchema()
.entity('Task').string('title', { required: true }).enum('status', ['todo', 'done']).done()
.build();
// src/index.ts
import { Mujarrad } from '@mujarrad/sdk';
import { schema } from './schema.js';
const client = new Mujarrad({
apiKey: process.env.MUJARRAD_PUBLIC_KEY!,
secretKey: process.env.MUJARRAD_SECRET_KEY!,
space: process.env.MUJARRAD_SPACE!,
}).withSchema(schema);
const task = await client.createEntity('Task', { title: 'Ship it', status: 'todo' });
npm start
See packages/sdk/README.md for full API reference, or browse the Developer Documentation:
Mujarrad CLI is engineered with a 5-layer abstraction—each layer refined, composable, and intelligent:
┌─────────────────────────────────────┐
│ Commands Layer │ ← CLI Interface
│ (User Interaction) │
└────────────┬────────────────────────┘
↓
┌─────────────────────────────────────┐
│ Services Layer │ ← Business Logic
│ (Core Intelligence) │
└────────────┬────────────────────────┘
↓
┌─────────────────────────────────────┐
│ Workflows Layer │ ← Orchestration
│ (Multi-Step Automation) │
└────────────┬────────────────────────┘
↓
┌─────────────────────────────────────┐
│ API Client Layer │ ← Communication
│ (Auto-Generated from OpenAPI) │
└────────────┬────────────────────────┘
↓
┌─────────────────────────────────────┐
│ File System Layer │ ← Data Source
│ (Vault Scanning & Parsing) │
└─────────────────────────────────────┘
Layered, scalable, elegant—architecture as art.
mujarrad auth login # Unlock your workspace
mujarrad auth logout # Secure logout
mujarrad auth status # Check authentication state
mujarrad workspace create # Build new workspace
mujarrad workspace list # View all workspaces
mujarrad workspace delete # Remove workspace
# Upload: Transform local vaults into structured workspaces
mujarrad upload <vault-path> --workspace <slug>
# Clone: Recreate workspaces as local vaults
mujarrad clone <target-path> --workspace <slug>
# Sync: Flow data bidirectionally
mujarrad sync <vault-path> [--watch]
mujarrad template list # Discover frameworks
mujarrad template clone <target-path> # Activate template
--template <id> # Framework identifier
--name <workspace-name> # Your workspace name
mujarrad sdk init <project-name> # Scaffold a new SDK project
mujarrad sdk keygen # Generate a new API key pair
mujarrad sdk keygen --name "production" # Generate a named key pair
mujarrad history <node-id> # View evolution
mujarrad history diff <node-id> <v1> <v2> # Compare versions
mujarrad --help # Master all commands
mujarrad <command> --help # Command-specific guidance
Mujarrad adapts to your environment. Configuration stored in ~/.mujarrad/config.json:
{
"apiBaseUrl": "https://mujarrad.onrender.com",
"defaultWorkspace": "my-workspace",
"autoSync": false,
"logLevel": "info"
}
Note: v1.1.0+ automatically migrates old config files with incorrect API URLs.
Secure by design, intelligent by default:
~/.mujarrad/credentials.json (permissions: 600)Accelerate planning with Business Model Canvas templates. Distill complex strategies into visual, actionable frameworks.
Unlock research potential with interconnected notes. Compose ideas into fluid, evolving knowledge graphs.
Master project complexity with structured templates. Track versions, synchronize teams, deliver results.
Engineer product roadmaps with canvas visualizations. Refine requirements, translate vision to reality.
# Upload complete business model vault
mujarrad upload ./business-models --workspace startup-canvas
# Visual properties preserved:
# • Node positions, sizes, colors
# • Edge connections and styles
# • Canvas-wide zoom and viewport settings
# • Wikilink relationships
# Discover available frameworks
mujarrad template list
# Activate Business Model Canvas template
mujarrad template clone ./my-startup \
--template business-model-canvas \
--name "My Startup"
# Template includes:
# • Pre-structured canvas layouts
# • Placeholder nodes with guidance
# • Template configuration file
# • Framework-specific structure
# Enable real-time sync with watch mode
mujarrad sync ./my-vault --watch
# Mujarrad monitors and responds:
# ✓ Detects: new files, updates, deletions
# ✓ Handles: conflict resolution, version tracking
# ✓ Flows: bidirectional synchronization
Traditional data tools complicate. They add layers of noise, require complex setup, and constrain flexibility.
Mujarrad simplifies. We:
| Concept | Traditional Approach | Mujarrad Approach |
|---|---|---|
| Abstraction | Hidden complexity, rigid structures | Composable blocks, polymorphic design |
| Data Flow | Manual, error-prone transfers | Automated, intelligent sync |
| Visual Design | Lost in translation | Pixel-perfect preservation |
| Scalability | Performance degradation | Engineered for scale |
| Flexibility | Locked into workflows | Adaptive, fluid by design |
# Diagnose authentication state
mujarrad auth status
# Reset and re-authenticate
mujarrad auth logout
mujarrad auth login
Note: If you installed v1.0.0-1.1.0-alpha.3 and experience 403 errors, simply upgrade to v1.1.0-alpha.4:
npm install -g mujarrad-cli@latest
The CLI will automatically fix your config file on next run.
Mujarrad uses intelligent conflict resolution:
Note-a1b2c3d4.md)# View detailed logs
tail -f ~/.mujarrad/logs/mujarrad.log
# Adjust log level in config
{
"logLevel": "debug" // Options: error, warn, info, debug
}
# Verify Git installation
git --version
# Configure Git identity
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git clone https://github.com/mujarrad/mujarrad-cli.git
cd mujarrad-cli
npm install
npm run build # Compile TypeScript
npm run dev # Development mode
npm start # Production mode
npm test # Run all tests
npm run test:watch # Watch mode
npm run test:coverage # Generate coverage report
Test-Driven Development: We engineer quality through comprehensive test coverage.
npm run lint # Check for errors
npm run lint:fix # Auto-fix issues
npm run format # Format code (Prettier)
@mujarrad/sdk npm package (nodes, attributes, spaces, batch)mujarrad sdk init project scaffoldingmujarrad sdk keygen API key generationCurrent Version: 1.2.0-alpha.2 - Published on npm
See tasks.md for detailed implementation plan.
Contributions empower the Mujarrad ecosystem. We welcome your innovations.
git checkout -b feature/amazing-feature)npm test)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)Abstract • Abstraction • Adaptive • Agile • Block • Composable • Complex • Data • Data-Driven • Direct • Distilled • Dynamic • Elastic • Elegant • Essential • Flexible • Fluid • Intelligent • Polymorphic • Powerful • Refined • Simple • Simplicity • Smart • Sophisticated • Universal
Accelerate • Activate • Adapt • Amplify • Automate • Build • Command • Compose • Create • Deliver • Demystify • Distill • Embrace • Empower • Engineer • Evolve • Harness • Innovate • Master • Realize • Refine • Reveal • Scale • Sculpt • Solve • Translate • Unlock • Unleash
Advantage • Agility • Art • Clarity • Edge • Efficiency • Flow • Focus • Foundation • Freedom • Insight • Logic • Order • Power • Potential • Scale • Signal • Solution • Speed • Structure • Superpower
Architecture • Blueprint • Blocks • Chaos • Code • Components • Core • Engine • Framework • Layer • Map • Maze • Noise • Platform • Source • System
Apache License 2.0 - see LICENSE file for details.
Freedom to build, adapt, and innovate.
Built with Intelligence. Designed for Power. Engineered for You.
Mujarrad: Where Data Complexity Becomes Elegant Simplicity
Website • Documentation • Community
DATA UNLOCKD
FAQs
⚠️ ALPHA: Obsidian Knowledge Graph Integration CLI - Sync your Obsidian vaults with Mujarrad workspaces
We found that mujarrad-cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.