automation

material-shell

Name: material-shell
Author: material-shell

A modern desktop interface for Linux. Improve your user experience and get rid of the anarchy of traditional desktop workflows. Designed to simplify navigation and reduce the need to manipulate windows in order to improve productivity. It's meant to be 100% predictable and bring the benefits of tools coveted by professionals to everyone.

7,241 stars+1★ this week181 forksTypeScriptUpdated 7/22/2024100% free · open source

What it does

Material Shell is a modern desktop interface for Linux that simplifies navigation and reduces window management to improve productivity.

When to use it

•When you want a more streamlined and efficient desktop experience on Linux
•When you need to simplify window management and focus on your work
•When you're looking for a predictable and easy-to-use desktop interface

Ready-to-paste prompt

ms-launch --layout ~/custom-layout.json

Heads up: Material Shell requires GNOME Shell version 40 or higher to function properly, so ensure you're running a compatible version before installation

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

🛠️ Technical setup

Expect 20–40 minutes in a terminal — or let your AI agent drive it.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/material-shell && curl -fsSL https://workflowstacks.com/api/skills/material-shell/claude-skill -o ~/.claude/skills/material-shell/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How material-shell works

Codeflow

Free to inspect

Material-shell is a very large TypeScript project (~62k lines across 227 code files). It is a full software project: use it through its install path rather than reading it end to end. Last commit 26 months ago, GPL-3.0 license, no tests found.

Size

Very large codebase

~62k lines · 227 code files · days to read — use, don't read

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

Node.js

No API keys detected

TypeScript 95%SCSS 3%Python 1%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
package.json
Dependencies and the commands it exposes
3
src/layout/main.ts
Inside src/ — the main logic begins here

What's in each folder

src/Core code — the actual logic94 files

documentation/Documentation8 files

@types/Folder141 files

@gi-types/Folder4 files

schemas/Data models & types4 files

scripts/Helper scripts3 files

assets/Images & static assets46 files

.github/CI / automation (GitHub Actions)6 files

READMENo tests foundDocumentedCI checksGPL-3.0 licenseLast update 26 mo ago