noslop 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ruben
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,170 @@
+# noslop
+
+> Let Claude Code manage your X posts - no slop, just good content
+
+[![npm version](https://img.shields.io/npm/v/noslop.svg)](https://www.npmjs.com/package/noslop)
+[![CI](https://github.com/rubenartus/noslop/actions/workflows/ci.yml/badge.svg)](https://github.com/rubenartus/noslop/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/noslop.svg)](https://nodejs.org)
+
+A CLI tool designed for AI assistants like Claude Code to draft, schedule, and manage your social media posts. All content lives as simple markdown files in folders - easy to version control, easy for AI to work with, easy for you to review.
+
+The TUI gives you a quick way to check what's scheduled, mark posts as ready, and keep your AI on track.
+
+## Screenshot
+
+![noslop TUI](./screenshot.jpg)
+
+## Features
+
+- **AI-first CLI** - Built for Claude Code to draft, schedule, and reschedule posts on demand
+- **Simple markdown files** - All content stored as `.md` files in `drafts/` and `posts/` folders
+- **Human-friendly TUI** - Review and direct the work with keyboard shortcuts
+- **Content workflow** - Draft → Ready → Post → Published pipeline
+- **Schedule view** - Calendar view of what's coming up
+
+## Installation
+
+```bash
+# npm
+npm install -g noslop
+
+# pnpm
+pnpm add -g noslop
+
+# Or run directly with npx
+npx noslop
+```
+
+## Quick Start
+
+```bash
+# Initialize a new project
+noslop init
+
+# Create a new draft
+noslop new "My First Post"
+
+# Open interactive TUI
+noslop
+```
+
+## Commands
+
+### Core Commands
+
+| Command | Description |
+|---------|-------------|
+| `noslop` | Open interactive TUI |
+| `noslop init [name]` | Initialize new project |
+| `noslop help` | Show all commands |
+
+### Content Management
+
+| Command | Description |
+|---------|-------------|
+| `noslop new <title>` | Create new draft |
+| `noslop list [-d\|--drafts] [-p\|--posts]` | List content |
+| `noslop status` | Show project summary |
+| `noslop show <id>` | Show full content |
+
+### Workflow Actions
+
+| Command | Description |
+|---------|-------------|
+| `noslop ready <id>` | Mark draft as ready |
+| `noslop unready <id>` | Mark as in-progress |
+| `noslop post <id>` | Move to posts folder |
+| `noslop unpost <id>` | Move back to drafts |
+| `noslop publish <id> <url>` | Add published URL |
+| `noslop schedule <id> <datetime>` | Set schedule (YYYY-MM-DD HH:MM) |
+| `noslop delete <id>` | Delete a draft |
+
+## TUI Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `Tab` | Switch between Drafts/Posts |
+| `↑/↓` | Navigate items |
+| `Enter` | Toggle ready (drafts) / Add URL (posts) |
+| `Space` | Move to Posts / Move to Drafts |
+| `Backspace` | Delete draft (in-progress only) |
+| `s` | Toggle schedule view |
+| `←/→` | Navigate weeks (schedule view) |
+| `q` | Quit |
+
+## Project Structure
+
+After running `noslop init`, your project will have:
+
+```
+your-project/
+├── CLAUDE.md      # Your brand voice & guidelines
+├── NOSLOP.md      # CLI documentation (auto-generated)
+├── drafts/        # Work in progress
+│   └── post-name/
+│       ├── x.md   # Post content
+│       └── assets/
+└── posts/         # Published content
+    └── post-name/
+        └── x.md
+```
+
+## Post File Format
+
+Each post is stored in `x.md` with this structure:
+
+```markdown
+# Post Title
+
+## Post
+\`\`\`
+Your post content here
+\`\`\`
+
+## Status
+draft | ready
+
+## Media
+Description of media to attach
+
+## Scheduled
+2026-01-27 09:00
+
+## Posted
+2026-01-27 09:15
+
+## Published
+https://x.com/user/status/123
+```
+
+## Working with AI Assistants
+
+noslop is designed to work with Claude Code and other AI assistants:
+
+1. **CLAUDE.md** - Add your brand voice, tone guidelines, and content rules
+2. **NOSLOP.md** - Auto-generated CLI documentation for AI reference
+3. Use CLI commands instead of manual file editing
+
+## Requirements
+
+- Node.js 18 or higher
+- Terminal with Unicode support
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+Made with love for content creators who prefer the terminal

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { isNoslopProject, getAllContent, findItem, createDraft, updateStatus, updateSchedule, moveToPosts, moveToDrafts, addPublishedUrl, deleteDraft, sortBySchedule, } from './lib/content.js';
+import { initProject, ensureNoslopMd } from './lib/templates.js';
+const program = new Command();
+program
+    .name('noslop')
+    .description('Social media content workflow CLI - no slop, just good content')
+    .version('0.1.0');
+// Default command: open TUI
+program.action(async () => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    // Ensure NOSLOP.md is up to date with current version
+    ensureNoslopMd();
+    // Dynamic import to avoid loading React/Ink for non-TUI commands
+    const { renderTUI } = await import('./tui.js');
+    renderTUI();
+});
+// Init command
+program
+    .command('init')
+    .description('Initialize a new noslop project in current directory')
+    .argument('[name]', 'Project name (optional)')
+    .action((name) => {
+    if (isNoslopProject()) {
+        console.log('Already a noslop project (drafts/ or posts/ exists).');
+        process.exit(1);
+    }
+    initProject(process.cwd(), name);
+    console.log('Initialized noslop project:');
+    console.log('  - drafts/     (your work in progress)');
+    console.log('  - posts/      (published content)');
+    console.log('  - CLAUDE.md   (your brand guidelines)');
+    console.log('  - NOSLOP.md   (tool documentation)');
+    console.log('');
+    console.log('Next: Run `noslop new "Your First Post"` to create a draft.');
+});
+// New draft command
+program
+    .command('new')
+    .description('Create a new draft')
+    .argument('<title>', 'Title for the new draft')
+    .action((title) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const item = createDraft(title);
+    console.log(`Created draft: ${item.folder}/`);
+    console.log(`  Edit: ${item.xFile}`);
+});
+// List command
+program
+    .command('list')
+    .description('List all content')
+    .option('-d, --drafts', 'Show only drafts')
+    .option('-p, --posts', 'Show only posts')
+    .action((options) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const { drafts, posts } = getAllContent();
+    if (!options.posts) {
+        const sortedDrafts = sortBySchedule(drafts);
+        if (sortedDrafts.length > 0) {
+            console.log('DRAFTS:');
+            for (const d of sortedDrafts) {
+                const status = d.status === 'ready' ? '✓' : '○';
+                const schedule = d.scheduledAt ? ` (${d.scheduledAt})` : '';
+                console.log(`  ${status} ${d.folder}${schedule}`);
+            }
+        }
+        else {
+            console.log('DRAFTS: (none)');
+        }
+    }
+    if (!options.drafts) {
+        if (!options.posts) {
+            console.log('');
+        }
+        if (posts.length > 0) {
+            console.log('POSTS:');
+            for (const p of posts) {
+                const url = p.published?.startsWith('http') ? ' ✓' : '';
+                const date = p.postedAt ? ` (${p.postedAt})` : '';
+                console.log(`  ${p.folder}${date}${url}`);
+            }
+        }
+        else {
+            console.log('POSTS: (none)');
+        }
+    }
+});
+// Status command
+program
+    .command('status')
+    .description('Show project status summary')
+    .action(() => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const { drafts, posts } = getAllContent();
+    const ready = drafts.filter(d => d.status === 'ready').length;
+    const wip = drafts.length - ready;
+    const published = posts.filter(p => p.published?.startsWith('http')).length;
+    console.log(`Drafts: ${drafts.length} (${ready} ready, ${wip} in progress)`);
+    console.log(`Posts: ${posts.length} (${published} with URL)`);
+    // Next scheduled
+    const scheduled = sortBySchedule(drafts).filter(d => d.scheduledAt);
+    if (scheduled.length > 0) {
+        console.log(`Next: ${scheduled[0].folder} @ ${scheduled[0].scheduledAt}`);
+    }
+});
+// Show command
+program
+    .command('show')
+    .description('Show full content of a post/draft')
+    .argument('<id>', 'Folder name or ID')
+    .action((id) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const item = findItem(id);
+    if (!item) {
+        console.log(`Not found: ${id}`);
+        process.exit(1);
+    }
+    console.log(`# ${item.title}`);
+    console.log(`Folder: ${item.folder}`);
+    console.log(`Status: ${item.status}`);
+    if (item.scheduledAt) {
+        console.log(`Scheduled: ${item.scheduledAt}`);
+    }
+    if (item.postedAt) {
+        console.log(`Posted: ${item.postedAt}`);
+    }
+    if (item.published) {
+        console.log(`URL: ${item.published}`);
+    }
+    if (item.media !== 'None') {
+        console.log(`Media: ${item.media}`);
+    }
+    console.log('---');
+    console.log(item.post);
+});
+// Ready command
+program
+    .command('ready')
+    .description('Mark draft as ready to post')
+    .argument('<id>', 'Folder name or ID')
+    .action((id) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const item = findItem(id);
+    if (!item) {
+        console.log(`Not found: ${id}`);
+        process.exit(1);
+    }
+    updateStatus(item, 'ready');
+    console.log(`Marked as ready: ${item.folder}`);
+});
+// Unready command
+program
+    .command('unready')
+    .description('Mark draft as in-progress')
+    .argument('<id>', 'Folder name or ID')
+    .action((id) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const item = findItem(id);
+    if (!item) {
+        console.log(`Not found: ${id}`);
+        process.exit(1);
+    }
+    updateStatus(item, 'draft');
+    console.log(`Marked as in-progress: ${item.folder}`);
+});
+// Post command (move to posts)
+program
+    .command('post')
+    .description('Move draft to posts folder')
+    .argument('<id>', 'Folder name or ID')
+    .action((id) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const item = findItem(id);
+    if (!item) {
+        console.log(`Not found: ${id}`);
+        process.exit(1);
+    }
+    moveToPosts(item);
+    console.log(`Moved to posts: ${item.folder}`);
+});
+// Unpost command (move back to drafts)
+program
+    .command('unpost')
+    .description('Move post back to drafts')
+    .argument('<id>', 'Folder name or ID')
+    .action((id) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const item = findItem(id);
+    if (!item) {
+        console.log(`Not found: ${id}`);
+        process.exit(1);
+    }
+    moveToDrafts(item);
+    console.log(`Moved to drafts: ${item.folder}`);
+});
+// Publish command
+program
+    .command('publish')
+    .description('Add published URL to post')
+    .argument('<id>', 'Folder name or ID')
+    .argument('<url>', 'Published URL')
+    .action((id, url) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const item = findItem(id);
+    if (!item) {
+        console.log(`Not found: ${id}`);
+        process.exit(1);
+    }
+    addPublishedUrl(item, url);
+    console.log(`Published: ${item.folder}`);
+    console.log(`  URL: ${url}`);
+});
+// Schedule command
+program
+    .command('schedule')
+    .description('Set/update scheduled time')
+    .argument('<id>', 'Folder name or ID')
+    .argument('<datetime>', 'Date and time (YYYY-MM-DD HH:MM)')
+    .action((id, datetime) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const item = findItem(id);
+    if (!item) {
+        console.log(`Not found: ${id}`);
+        process.exit(1);
+    }
+    updateSchedule(item, datetime);
+    console.log(`Scheduled: ${item.folder} @ ${datetime}`);
+});
+// Delete command
+program
+    .command('delete')
+    .description('Delete a draft')
+    .argument('<id>', 'Folder name or ID')
+    .action((id) => {
+    if (!isNoslopProject()) {
+        console.log('Not a noslop project. Run `noslop init` first.');
+        process.exit(1);
+    }
+    const item = findItem(id);
+    if (!item) {
+        console.log(`Not found: ${id}`);
+        process.exit(1);
+    }
+    deleteDraft(item);
+    console.log(`Deleted: ${item.folder}`);
+});
+program.parse();

package/dist/lib/content.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Status of a content item (draft or ready to post)
+ */
+export type ContentStatus = 'draft' | 'ready';
+/**
+ * Represents a content item (draft or post)
+ */
+export interface ContentItem {
+    id: string;
+    folder: string;
+    title: string;
+    post: string;
+    published: string;
+    media: string;
+    postedAt: string;
+    scheduledAt: string;
+    status: ContentStatus;
+    path: string;
+    xFile: string;
+}
+/**
+ * Validate that a string is a valid URL
+ * @param str - String to validate
+ * @returns True if valid URL, false otherwise
+ */
+export declare function isValidUrl(str: string): boolean;
+/**
+ * Get the paths to posts and drafts directories
+ * @param cwd - Working directory (defaults to process.cwd())
+ * @returns Object with postsDir and draftsDir paths
+ */
+export declare function getContentDirs(cwd?: string): {
+    postsDir: string;
+    draftsDir: string;
+};
+/**
+ * Check if the current directory is a noslop project
+ * @param cwd - Working directory to check
+ * @returns True if drafts/ or posts/ directory exists
+ */
+export declare function isNoslopProject(cwd?: string): boolean;
+/**
+ * Parse content from a directory into ContentItem objects
+ * @param dir - Directory containing content folders
+ * @param prefix - ID prefix ('D' for drafts, 'P' for posts)
+ * @returns Array of parsed content items, sorted alphabetically by folder name
+ */
+export declare function parseContent(dir: string, prefix: string): ContentItem[];
+/**
+ * Get all drafts from the drafts directory
+ * @param cwd - Working directory
+ * @returns Array of draft content items
+ */
+export declare function getDrafts(cwd?: string): ContentItem[];
+/**
+ * Get all posts from the posts directory
+ * @param cwd - Working directory
+ * @returns Array of post content items
+ */
+export declare function getPosts(cwd?: string): ContentItem[];
+/**
+ * Get all content (drafts + posts)
+ * @param cwd - Working directory
+ * @returns Object with drafts and posts arrays
+ */
+export declare function getAllContent(cwd?: string): {
+    drafts: ContentItem[];
+    posts: ContentItem[];
+};
+/**
+ * Find a content item by folder name or ID
+ * @param query - Folder name (exact or partial) or ID (D001, P001)
+ * @param cwd - Working directory
+ * @returns Matching content item or null if not found
+ * @throws Error if query contains path traversal patterns
+ * @example
+ * findItem('monday-motivation') // exact folder match
+ * findItem('monday') // partial folder match
+ * findItem('D001') // ID match
+ */
+export declare function findItem(query: string, cwd?: string): ContentItem | null;
+/**
+ * Create a new draft with the given title
+ * @param title - Title for the draft (will be slugified for folder name)
+ * @param cwd - Working directory
+ * @returns The created ContentItem
+ * @throws Error if draft creation fails
+ */
+export declare function createDraft(title: string, cwd?: string): ContentItem;
+/**
+ * Update the status of a content item
+ * @param item - Content item to update
+ * @param newStatus - New status ('draft' or 'ready')
+ * @throws Error if file operations fail
+ */
+export declare function updateStatus(item: ContentItem, newStatus: ContentStatus): void;
+/**
+ * Update the scheduled date of a content item
+ * @param item - Content item to update
+ * @param datetime - Scheduled datetime string (YYYY-MM-DD HH:MM)
+ * @throws Error if file operations fail
+ */
+export declare function updateSchedule(item: ContentItem, datetime: string): void;
+/**
+ * Move a draft to the posts folder
+ * @param item - Content item to move
+ * @param cwd - Working directory
+ * @throws Error if move operation fails
+ */
+export declare function moveToPosts(item: ContentItem, cwd?: string): void;
+/**
+ * Move a post back to the drafts folder
+ * @param item - Content item to move
+ * @param cwd - Working directory
+ * @throws Error if move operation fails
+ */
+export declare function moveToDrafts(item: ContentItem, cwd?: string): void;
+/**
+ * Add a published URL to a post
+ * @param item - Content item to update
+ * @param url - Published URL
+ * @throws Error if URL is invalid or file operations fail
+ */
+export declare function addPublishedUrl(item: ContentItem, url: string): void;
+/**
+ * Delete a draft
+ * @param item - Content item to delete
+ * @throws Error if delete operation fails
+ */
+export declare function deleteDraft(item: ContentItem): void;
+/**
+ * Format a date as YYYY-MM-DD HH:MM
+ * @param date - Date to format
+ * @returns Formatted date string
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Sort content items by scheduled date (oldest first)
+ * Unscheduled items are placed at the end
+ * @param items - Array of content items to sort
+ * @returns New sorted array (does not mutate original)
+ */
+export declare function sortBySchedule(items: ContentItem[]): ContentItem[];