freshell Skill

How to use freshell Skill

npm run dev     # Development with hot reload
npm run serve   # Production build and run

Use absolute paths — relative symlinks break when the working directory changes.
7. **Restart Freshell** for the extension to be discovered.
8. **Verify** — open the pane picker, confirm the extension appears, open it, confirm it works.

## Workflow: Install from Local Directory

1. **Check for `freshell.json`** — if missing, create one (see manifest reference above).
2. **Build if needed** — check if the project requires a build step and run it.
3. **Symlink:**
   ```bash
   mkdir -p ~/.freshell/extensions
   ln -sf /absolute/path/to/project ~/.freshell/extensions/<name>
   ```
4. **Restart Freshell.**
5. **Verify** in the pane picker.

## Workflow: Create from Scratch

### Minimal server extension

Create a directory with two files:

**`index.js`:**
```javascript
const http = require('http');
const port = process.env.PORT || 3000;
const server = http.createServer((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/html' });
  res.end('<h1>Hello from my extension</h1>');
});
server.listen(port, () => console.log(`Listening on port ${port}`));
```

**`freshell.json`:**
```json
{
  "name": "hello-server",
  "version": "0.1.0",
  "label": "Hello Server",
  "description": "Mi

What is freshell Skill?

freshell is a TypeScript AI agent skill for Claude Desktop, Codex with npx, git clone. The Agentic IDE (or, the loving child of tmux and claude code) This profile combines repository metadata with install, compatibility, and usage signals so developers can quickly decide whether it fits their agent workflow before opening the source repository.

Key capabilities

• Reusable instructions support
• Includes SKILL.md support
• Shell commands support
• Browser use support
• Anthropic provider support
• Google provider support
• package.json config support

Available tools

Technical details

Install or run freshell using npx. Check danshapiro/freshell for the latest setup command.

• Built for TypeScript
• Built for Node.js
• Built for Python
• Install or run with npx
• Install or run with git clone
• Works with Claude Desktop
• Works with Codex
• Uses HTTP transport

Requirements and access

Security and permissions

Review permissions before connecting any MCP server to an agent. Pay special attention to whether it can read local files, write data, call external services, or perform destructive actions.

When to use freshell Skill

• Use it for reusing agent instructions, scripts, and references.
• Use it for agent skills workflows.
• Use it for coding workflows.
• Use it for data workflows.
• Use it for claude desktop users.

Built with

Explore related resources

Frequently asked questions