claudenews 1.0.0

package/README.md

@@ -0,0 +1,97 @@
+# claudenews
+
+News headlines in your Claude Code spinner. Instead of "Thinking..." you get real headlines from Hacker News, Reddit, Lobsters, dev.to, and GitHub Trending.
+
+```
+* [HN] UUID package coming to Go standard library
+● Searching for 1 pattern, reading 7 files...
+```
+
+## Install
+
+```bash
+npx claudenews
+```
+
+Or install globally:
+
+```bash
+npm install -g claudenews
+claudenews
+```
+
+That's it. First run automatically:
+- Creates config at `~/.claudenews/config.json`
+- Fetches headlines from your enabled sources
+- Installs Claude Code hooks for automatic refresh
+- Writes headlines to your spinner
+
+## Pick your sources
+
+Run `claudenews` to open the source picker:
+
+```
+claudenews — pick your news sources
+
+> [x] [HN] Hacker News          news.ycombinator.com
+  [ ] [/r] Reddit                reddit.com
+  [ ] [🦞] Lobsters              lobste.rs
+  [ ] [dev] dev.to               dev.to
+  [ ] [GH] GitHub Trending       github.com/trending
+
+[Space] Toggle  [r] Refresh  [q] Quit          built by souls.zip
+```
+
+Headlines show up in your Claude Code spinner with source prefixes:
+
+- `[HN]` — Hacker News
+- `[/r]` — Reddit (r/programming, r/technology)
+- `[🦞]` — Lobsters
+- `[dev]` — dev.to
+- `[GH]` — GitHub Trending
+
+## How it works
+
+- **Session start hook** fetches fresh headlines every time you start Claude Code
+- **Pre-tool-use hook** refreshes if headlines are older than 30 minutes
+- Headlines are written to `spinnerVerbs` in `~/.claude/settings.json`
+- Claude Code reads spinner verbs at session startup
+
+## Configuration
+
+Config lives at `~/.claudenews/config.json`:
+
+```json
+{
+  "headlineCount": 15,
+  "refreshIntervalMinutes": 30,
+  "enabledSources": ["hackernews"],
+  "redditSubs": ["programming", "technology"]
+}
+```
+
+- **headlineCount** — headlines per source (default: 15)
+- **refreshIntervalMinutes** — how often to fetch new headlines (default: 30)
+- **enabledSources** — which sources to pull from
+- **redditSubs** — subreddits to include when Reddit is enabled
+
+## Uninstall
+
+```bash
+claudenews --uninstall
+```
+
+Removes hooks, restores default spinner, and deletes config.
+
+## Requirements
+
+- Node.js 18+
+- Claude Code
+
+## License
+
+MIT
+
+---
+
+Built by [souls.zip](https://souls.zip)

package/bin/claudenews.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import '../dist/cli.js';
+

package/dist/app.d.ts

@@ -0,0 +1 @@
+export default function App(): import("react/jsx-runtime").JSX.Element;

package/dist/app.js

@@ -0,0 +1,80 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+import { Box, Text, useInput, useApp } from 'ink';
+import { readConfig, writeConfig } from './lib/config.js';
+import { getAllSources } from './lib/sources/index.js';
+import { refresh } from './lib/refresh.js';
+export default function App() {
+    const { exit } = useApp();
+    const [sources, setSources] = useState([]);
+    const [enabled, setEnabled] = useState([]);
+    const [cursor, setCursor] = useState(0);
+    const [status, setStatus] = useState('');
+    const [refreshing, setRefreshing] = useState(false);
+    useEffect(() => {
+        (async () => {
+            const config = await readConfig();
+            setEnabled(config.enabledSources);
+            setSources(getAllSources());
+            // Auto-refresh on open
+            try {
+                await refresh();
+                setStatus('Headlines updated — restart Claude Code to apply');
+            }
+            catch { }
+        })();
+    }, []);
+    // Periodic refresh
+    useEffect(() => {
+        const id = setInterval(async () => {
+            try {
+                await refresh();
+                setStatus('Headlines updated — restart Claude Code to apply');
+            }
+            catch { }
+        }, 30 * 60 * 1000);
+        return () => clearInterval(id);
+    }, []);
+    useInput((input, key) => {
+        if (input === 'q')
+            return exit();
+        if (key.upArrow || input === 'k')
+            setCursor(i => Math.max(0, i - 1));
+        if (key.downArrow || input === 'j')
+            setCursor(i => Math.min(sources.length - 1, i + 1));
+        if (input === ' ') {
+            const src = sources[cursor];
+            if (!src)
+                return;
+            setEnabled(prev => {
+                const next = prev.includes(src.id)
+                    ? prev.filter(id => id !== src.id)
+                    : [...prev, src.id];
+                setStatus('Saving...');
+                readConfig().then(config => {
+                    writeConfig({ ...config, enabledSources: next })
+                        .then(() => refresh())
+                        .then(() => setStatus('Updated — restart Claude Code to apply'))
+                        .catch(() => setStatus('Failed to refresh'));
+                });
+                return next;
+            });
+        }
+        if (input === 'r' && !refreshing) {
+            setRefreshing(true);
+            setStatus('Refreshing headlines...');
+            refresh()
+                .then(() => setStatus('Refreshed — restart Claude Code to apply'))
+                .catch(() => setStatus('Failed to refresh'))
+                .finally(() => setRefreshing(false));
+        }
+    });
+    if (sources.length === 0) {
+        return _jsx(Text, { dimColor: true, children: "Loading..." });
+    }
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Box, { marginBottom: 1, children: [_jsx(Text, { bold: true, children: "claudenews" }), _jsx(Text, { dimColor: true, children: " \u2014 pick your news sources" })] }), sources.map((src, i) => {
+                const active = i === cursor;
+                const on = enabled.includes(src.id);
+                return (_jsxs(Box, { children: [_jsxs(Text, { bold: active, children: [active ? '> ' : '  ', on ? '[x]' : '[ ]', " ", src.prefix, " ", src.name] }), _jsxs(Text, { dimColor: true, children: [" ", src.url] })] }, src.id));
+            }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: "[Space] Toggle  [r] Refresh  [q] Quit | by souls.zip & @tolibear_" }) }), status && (_jsx(Box, { marginTop: 0, children: _jsx(Text, { dimColor: true, children: status }) }))] }));
+}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli.js

@@ -0,0 +1,40 @@
+import { existsSync } from 'node:fs';
+import { mkdir, rm } from 'node:fs/promises';
+import React from 'react';
+import { render } from 'ink';
+import { getConfigDir, readConfig, writeConfig } from './lib/config.js';
+import { refresh } from './lib/refresh.js';
+import { installHooks, removeHooks, restoreDefaultVerbs } from './lib/settings.js';
+import App from './app.js';
+async function autoSetup() {
+    const configPath = `${getConfigDir()}/config.json`;
+    if (existsSync(configPath))
+        return;
+    await mkdir(getConfigDir(), { recursive: true });
+    await writeConfig(await readConfig());
+    try {
+        await refresh();
+    }
+    catch { }
+    await installHooks();
+}
+async function uninstall() {
+    console.log('Uninstalling claudenews...\n');
+    await removeHooks();
+    await restoreDefaultVerbs();
+    try {
+        await rm(getConfigDir(), { recursive: true });
+        console.log(`Removed ${getConfigDir()}`);
+    }
+    catch { }
+    console.log('Done! Spinner restored to defaults.');
+}
+async function main() {
+    if (process.argv.includes('--uninstall')) {
+        await uninstall();
+        return;
+    }
+    await autoSetup();
+    render(React.createElement(App));
+}
+main();

package/dist/hooks/on-pre-tool-use.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/on-pre-tool-use.js

@@ -0,0 +1,14 @@
+import { readConfig } from '../lib/config.js';
+import { refresh, isStale } from '../lib/refresh.js';
+async function main() {
+    let input = '';
+    for await (const chunk of process.stdin)
+        input += chunk;
+    try {
+        const config = await readConfig();
+        if (isStale(config))
+            await refresh();
+    }
+    catch { }
+}
+main();

package/dist/hooks/on-session-start.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/hooks/on-session-start.js

@@ -0,0 +1,11 @@
+import { refresh } from '../lib/refresh.js';
+async function main() {
+    let input = '';
+    for await (const chunk of process.stdin)
+        input += chunk;
+    try {
+        await refresh();
+    }
+    catch { }
+}
+main();

package/dist/lib/config.d.ts

@@ -0,0 +1,10 @@
+export interface Config {
+    headlineCount: number;
+    refreshIntervalMinutes: number;
+    enabledSources: string[];
+    redditSubs: string[];
+    lastRefresh?: string;
+}
+export declare function getConfigDir(): string;
+export declare function readConfig(): Promise<Config>;
+export declare function writeConfig(config: Config): Promise<void>;

package/dist/lib/config.js

@@ -0,0 +1,29 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const defaultConfig = {
+    headlineCount: 15,
+    refreshIntervalMinutes: 30,
+    enabledSources: ['hackernews'],
+    redditSubs: ['programming', 'technology'],
+};
+export function getConfigDir() {
+    return join(homedir(), '.claudenews');
+}
+function getConfigPath() {
+    return join(getConfigDir(), 'config.json');
+}
+export async function readConfig() {
+    try {
+        const raw = await readFile(getConfigPath(), 'utf-8');
+        return { ...defaultConfig, ...JSON.parse(raw) };
+    }
+    catch {
+        return { ...defaultConfig };
+    }
+}
+export async function writeConfig(config) {
+    const dir = getConfigDir();
+    await mkdir(dir, { recursive: true });
+    await writeFile(getConfigPath(), JSON.stringify(config, null, 2) + '\n');
+}

package/dist/lib/refresh.d.ts

@@ -0,0 +1,5 @@
+export declare function refresh(): Promise<void>;
+export declare function isStale(config: {
+    lastRefresh?: string;
+    refreshIntervalMinutes: number;
+}): boolean;

package/dist/lib/refresh.js

@@ -0,0 +1,23 @@
+import { readConfig, writeConfig } from './config.js';
+import { fetchAllHeadlines, getPrefix } from './sources/index.js';
+import { writeSpinnerVerbs } from './settings.js';
+export async function refresh() {
+    const config = await readConfig();
+    const headlines = await fetchAllHeadlines(config.enabledSources, config.headlineCount);
+    const MAX_LEN = 80;
+    const verbs = headlines
+        .map(h => {
+        const prefix = getPrefix(h.source);
+        const full = `${prefix} ${h.title}`;
+        return full.length > MAX_LEN ? `${full.slice(0, MAX_LEN - 1)}…` : full;
+    })
+        .filter(v => v.length > 0);
+    await writeSpinnerVerbs(verbs);
+    await writeConfig({ ...config, lastRefresh: new Date().toISOString() });
+}
+export function isStale(config) {
+    if (!config.lastRefresh)
+        return true;
+    const age = Date.now() - new Date(config.lastRefresh).getTime();
+    return age > config.refreshIntervalMinutes * 60 * 1000;
+}

package/dist/lib/settings.d.ts

@@ -0,0 +1,4 @@
+export declare function writeSpinnerVerbs(verbs: string[]): Promise<void>;
+export declare function restoreDefaultVerbs(): Promise<void>;
+export declare function installHooks(): Promise<void>;
+export declare function removeHooks(): Promise<void>;

package/dist/lib/settings.js

@@ -0,0 +1,69 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { join, resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
+async function readSettings() {
+    try {
+        const raw = await readFile(SETTINGS_PATH, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+async function saveSettings(settings) {
+    await writeFile(SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n');
+}
+export async function writeSpinnerVerbs(verbs) {
+    const settings = await readSettings();
+    settings.spinnerVerbs = { mode: 'replace', verbs };
+    await saveSettings(settings);
+}
+export async function restoreDefaultVerbs() {
+    const settings = await readSettings();
+    delete settings.spinnerVerbs;
+    await saveSettings(settings);
+}
+function getDistDir() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), '..');
+}
+function getHookCommand(scriptName) {
+    return `node "${join(getDistDir(), 'hooks', scriptName)}"`;
+}
+const MARKER = 'claudenews';
+export async function installHooks() {
+    const settings = await readSettings();
+    if (!settings.hooks)
+        settings.hooks = {};
+    for (const [event, script, timeout] of [
+        ['SessionStart', 'on-session-start.js', 15000],
+        ['PreToolUse', 'on-pre-tool-use.js', 10000],
+    ]) {
+        const cmd = getHookCommand(script);
+        if (!settings.hooks[event])
+            settings.hooks[event] = [];
+        const existing = settings.hooks[event].find(e => e.hooks?.some(h => h.command.includes(MARKER)));
+        const hookEntry = { type: 'command', command: cmd, timeout };
+        if (existing) {
+            existing.hooks = [hookEntry];
+        }
+        else {
+            settings.hooks[event].push({ hooks: [hookEntry] });
+        }
+    }
+    await saveSettings(settings);
+}
+export async function removeHooks() {
+    const settings = await readSettings();
+    if (!settings.hooks)
+        return;
+    for (const event of Object.keys(settings.hooks)) {
+        settings.hooks[event] = settings.hooks[event].filter(e => !e.hooks?.some(h => h.command.includes(MARKER)));
+        if (settings.hooks[event].length === 0)
+            delete settings.hooks[event];
+    }
+    if (Object.keys(settings.hooks).length === 0)
+        delete settings.hooks;
+    await saveSettings(settings);
+}

package/dist/lib/sources/devto.d.ts

@@ -0,0 +1,3 @@
+import type { SourceDef } from '../types.js';
+declare const devto: SourceDef;
+export default devto;

package/dist/lib/sources/devto.js

@@ -0,0 +1,20 @@
+const devto = {
+    id: 'devto',
+    name: 'dev.to',
+    prefix: '[dev]',
+    url: 'dev.to',
+    defaultEnabled: false,
+    async fetch(count) {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), 10_000);
+        try {
+            const r = await fetch(`https://dev.to/api/articles?per_page=${count}`, { signal: ctrl.signal });
+            const items = await r.json();
+            return items.map(i => ({ title: i.title, source: 'devto' }));
+        }
+        finally {
+            clearTimeout(t);
+        }
+    },
+};
+export default devto;

package/dist/lib/sources/github-trending.d.ts

@@ -0,0 +1,3 @@
+import type { SourceDef } from '../types.js';
+declare const githubTrending: SourceDef;
+export default githubTrending;

package/dist/lib/sources/github-trending.js

@@ -0,0 +1,23 @@
+const githubTrending = {
+    id: 'github',
+    name: 'GitHub Trending',
+    prefix: '[GH]',
+    url: 'github.com/trending',
+    defaultEnabled: false,
+    async fetch(count) {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), 10_000);
+        try {
+            const r = await fetch('https://ghapi.huchen.dev/repositories?since=daily', { signal: ctrl.signal });
+            const repos = await r.json();
+            return repos.slice(0, count).map(i => ({
+                title: i.description ? `${i.author}/${i.name} — ${i.description}` : `${i.author}/${i.name}`,
+                source: 'github',
+            }));
+        }
+        finally {
+            clearTimeout(t);
+        }
+    },
+};
+export default githubTrending;

package/dist/lib/sources/hackernews.d.ts

@@ -0,0 +1,3 @@
+import type { SourceDef } from '../types.js';
+declare const hackernews: SourceDef;
+export default hackernews;

package/dist/lib/sources/hackernews.js

@@ -0,0 +1,24 @@
+const hackernews = {
+    id: 'hackernews',
+    name: 'Hacker News',
+    prefix: '[HN]',
+    url: 'news.ycombinator.com',
+    defaultEnabled: true,
+    async fetch(count) {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), 10_000);
+        try {
+            const res = await fetch('https://hacker-news.firebaseio.com/v0/topstories.json', { signal: ctrl.signal });
+            const ids = await res.json();
+            const items = await Promise.all(ids.slice(0, count).map(async (id) => {
+                const r = await fetch(`https://hacker-news.firebaseio.com/v0/item/${id}.json`, { signal: ctrl.signal });
+                return r.json();
+            }));
+            return items.filter(i => i?.title).map(i => ({ title: i.title, source: 'hackernews' }));
+        }
+        finally {
+            clearTimeout(t);
+        }
+    },
+};
+export default hackernews;

package/dist/lib/sources/index.d.ts

@@ -0,0 +1,4 @@
+import type { Headline, SourceDef } from '../types.js';
+export declare function getAllSources(): SourceDef[];
+export declare function getPrefix(source: string): string;
+export declare function fetchAllHeadlines(enabledIds: string[], countPerSource: number): Promise<Headline[]>;

package/dist/lib/sources/index.js

@@ -0,0 +1,27 @@
+import hackernews from './hackernews.js';
+import reddit from './reddit.js';
+import lobsters from './lobsters.js';
+import devto from './devto.js';
+import githubTrending from './github-trending.js';
+const allSources = [hackernews, reddit, lobsters, devto, githubTrending];
+export function getAllSources() {
+    return allSources;
+}
+export function getPrefix(source) {
+    return allSources.find(s => s.id === source)?.prefix ?? `[${source}]`;
+}
+export async function fetchAllHeadlines(enabledIds, countPerSource) {
+    const sources = allSources.filter(s => enabledIds.includes(s.id));
+    const results = await Promise.allSettled(sources.map(s => s.fetch(countPerSource)));
+    const headlines = [];
+    for (const result of results) {
+        if (result.status === 'fulfilled')
+            headlines.push(...result.value);
+    }
+    // Fisher-Yates shuffle
+    for (let i = headlines.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        [headlines[i], headlines[j]] = [headlines[j], headlines[i]];
+    }
+    return headlines;
+}

package/dist/lib/sources/lobsters.d.ts

@@ -0,0 +1,3 @@
+import type { SourceDef } from '../types.js';
+declare const lobsters: SourceDef;
+export default lobsters;

package/dist/lib/sources/lobsters.js

@@ -0,0 +1,20 @@
+const lobsters = {
+    id: 'lobsters',
+    name: 'Lobsters',
+    prefix: '[🦞]',
+    url: 'lobste.rs',
+    defaultEnabled: false,
+    async fetch(count) {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), 10_000);
+        try {
+            const r = await fetch('https://lobste.rs/hottest.json', { signal: ctrl.signal });
+            const items = await r.json();
+            return items.slice(0, count).map(i => ({ title: i.title, source: 'lobsters' }));
+        }
+        finally {
+            clearTimeout(t);
+        }
+    },
+};
+export default lobsters;

package/dist/lib/sources/reddit.d.ts

@@ -0,0 +1,3 @@
+import type { SourceDef } from '../types.js';
+declare const reddit: SourceDef;
+export default reddit;

package/dist/lib/sources/reddit.js

@@ -0,0 +1,28 @@
+import { readConfig } from '../config.js';
+const reddit = {
+    id: 'reddit',
+    name: 'Reddit',
+    prefix: '[/r]',
+    url: 'reddit.com',
+    defaultEnabled: false,
+    async fetch(count) {
+        const ctrl = new AbortController();
+        const t = setTimeout(() => ctrl.abort(), 10_000);
+        try {
+            const config = await readConfig();
+            const perSub = Math.max(1, Math.floor(count / config.redditSubs.length));
+            const results = await Promise.all(config.redditSubs.map(async (sub) => {
+                const r = await fetch(`https://www.reddit.com/r/${sub}/hot.json?limit=${perSub}`, {
+                    signal: ctrl.signal,
+                    headers: { 'User-Agent': 'claudenews/1.0' },
+                });
+                return r.json();
+            }));
+            return results.flatMap(r => r.data.children.map(c => ({ title: c.data.title, source: 'reddit' })));
+        }
+        finally {
+            clearTimeout(t);
+        }
+    },
+};
+export default reddit;

package/dist/lib/types.d.ts

@@ -0,0 +1,12 @@
+export interface Headline {
+    title: string;
+    source: string;
+}
+export interface SourceDef {
+    id: string;
+    name: string;
+    prefix: string;
+    url: string;
+    defaultEnabled: boolean;
+    fetch(count: number): Promise<Headline[]>;
+}

package/dist/lib/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "claudenews",
+  "version": "1.0.0",
+  "description": "News headlines in your Claude Code spinner",
+  "type": "module",
+  "bin": {
+    "claudenews": "./bin/claudenews.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "news",
+    "spinner",
+    "hackernews",
+    "cli",
+    "tui"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tolibear/claudenews"
+  },
+  "author": "souls.zip",
+  "homepage": "https://github.com/tolibear/claudenews",
+  "dependencies": {
+    "ink": "^5.2.0",
+    "react": "^18.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/react": "^18.3.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT"
+}