@cyberdrk/tg 0.1.1

package/README.md

@@ -0,0 +1,123 @@
+# tg - Telegram CLI
+
+Fast Telegram CLI for reading, searching, and sending messages. Designed for both interactive use and AI agent integration.
+
+## Installation
+
+```bash
+npm install -g @cyberdrk/tg
+```
+
+Or install from source:
+
+```bash
+git clone https://github.com/cyberdrk305/telegram.git
+cd telegram
+npm install
+npm run build
+npm link
+```
+
+## Authentication
+
+First, get your API credentials:
+1. Go to https://my.telegram.org/apps
+2. Log in with your phone number
+3. Create a new application
+4. Copy the `api_id` and `api_hash`
+
+Then authenticate:
+
+```bash
+tg auth
+```
+
+## Commands
+
+### Auth & Status
+
+```bash
+tg whoami                              # Show logged-in account
+tg check                               # Verify session/credentials
+```
+
+### Reading
+
+```bash
+tg chats                               # List all chats
+tg chats --type group                  # Filter by type (user, group, supergroup, channel)
+tg read "MetaDAO Community" -n 50      # Read last 50 messages
+tg read "MetaDAO" --since "1h"         # Messages from last hour
+tg read @username -n 20                # Read DM with user
+tg search "futarchy" --chat "MetaDAO"  # Search within chat
+tg search "futarchy" --all             # Search all chats
+tg inbox                               # Unread messages summary
+```
+
+### Writing
+
+```bash
+tg send @username "Hello"              # Send DM
+tg send "GroupName" "Hello everyone"   # Send to group
+tg reply "ChatName" 12345 "Response"   # Reply to message ID
+```
+
+### Contacts & Groups
+
+```bash
+tg contact @username                   # Get contact info
+tg members "GroupName"                 # List group members
+tg admins "GroupName"                  # List admins only
+tg groups                              # List all groups
+tg groups --admin                      # Groups where you're admin
+```
+
+### Utilities
+
+```bash
+tg sync --days 7                       # Sync last 7 days to markdown
+tg sync --chat "MetaDAO" --days 30     # Sync specific chat
+```
+
+## Output Formats
+
+All read commands support multiple output formats:
+
+```bash
+tg chats --json                        # JSON (for scripts/AI)
+tg read "Chat" --markdown              # Markdown format
+tg inbox --plain                       # Plain text (no colors)
+```
+
+## Configuration
+
+Configuration is stored in `~/.config/tg/`:
+- `config.json` - API credentials and session
+- Session data is encrypted and stored securely
+
+## Claude Code Skill
+
+This package includes a Claude Code skill for AI agent integration. To install:
+
+```bash
+# Symlink the skill to your Claude skills directory
+mkdir -p ~/.claude/skills
+ln -s $(npm root -g)/@cyberdrk/tg/SKILL.md ~/.claude/skills/tg.md
+```
+
+Or if installed from source:
+```bash
+ln -s ~/Code/cyberdrk305/telegram/SKILL.md ~/.claude/skills/tg.md
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run dev                            # Watch mode
+```
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: tg
+description: Telegram CLI for reading, searching, and sending messages. Use when the user asks about Telegram messages, wants to check inbox, search chats, send messages, or look up contacts and groups.
+---
+
+# Telegram CLI
+
+Fast Telegram CLI for reading, searching, and sending messages.
+
+## When to Use
+
+Use this skill when the user:
+- Asks to check Telegram messages or inbox
+- Wants to search Telegram for a topic/keyword
+- Wants to send a Telegram message to someone
+- Asks about a Telegram group, contact, or chat
+- Wants to see unread messages
+- Needs to look up group members or admins
+
+## Install
+
+```bash
+npm install -g @cyberdrk/tg
+```
+
+Or from source:
+```bash
+cd ~/Code/cyberdrk305/telegram && npm install && npm run build && npm link
+```
+
+## Authentication
+
+First-time setup requires API credentials from https://my.telegram.org/apps
+
+```bash
+tg auth
+```
+
+## Commands
+
+### Reading
+```bash
+tg inbox                               # Unread messages summary
+tg chats                               # List all chats
+tg read "ChatName" -n 50               # Read last 50 messages
+tg read "ChatName" --since "1h"        # Messages from last hour
+tg read @username -n 20                # Read DM with user
+tg search "query" --chat "ChatName"    # Search within chat
+tg search "query" --all                # Search all chats
+```
+
+### Writing
+```bash
+tg send @username "message"            # Send DM
+tg send "GroupName" "message"          # Send to group
+tg reply "ChatName" 12345 "response"   # Reply to message ID
+```
+
+### Contacts & Groups
+```bash
+tg contact @username                   # Get contact info
+tg members "GroupName"                 # List group members
+tg admins "GroupName"                  # List admins only
+tg groups --admin                      # Groups where you're admin
+```
+
+### Status
+```bash
+tg whoami                              # Show logged-in account
+tg check                               # Verify session
+```
+
+## Output Formats
+
+All commands support `--json` for structured output suitable for processing:
+
+```bash
+tg inbox --json                        # JSON format
+tg read "Chat" --json                  # JSON with messages array
+tg chats --json                        # JSON with chat list
+```
+
+## Examples
+
+Check inbox:
+```bash
+tg inbox
+```
+
+Read recent messages from a chat:
+```bash
+tg read "MetaDAO Community" -n 20
+```
+
+Search for a topic:
+```bash
+tg search "futarchy" --chat "MetaDAO"
+```
+
+Send a message:
+```bash
+tg send @username "Hello, checking in!"
+```
+
+## Notes
+
+- Chat names can be partial matches (e.g., "MetaDAO" matches "MetaDAO Community")
+- Usernames must start with @ (e.g., @username)
+- Messages are returned in reverse chronological order (newest first)
+- The `--since` flag accepts formats like "1h", "30m", "7d"

package/dist/auth.d.ts

@@ -0,0 +1,4 @@
+import { TelegramClient } from 'telegram';
+export declare function authenticate(): Promise<TelegramClient>;
+export declare function checkAuth(client: TelegramClient): Promise<boolean>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAmB1C,wBAAsB,YAAY,IAAI,OAAO,CAAC,cAAc,CAAC,CA6C5D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAOxE"}

package/dist/auth.js

@@ -0,0 +1,61 @@
+import { TelegramClient } from 'telegram';
+import { StringSession } from 'telegram/sessions/index.js';
+import { createInterface } from 'readline';
+import { setCredentials, setSessionString } from './config.js';
+function prompt(question) {
+    const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+export async function authenticate() {
+    console.log('\nTelegram Authentication Setup\n');
+    console.log('To get your API credentials:');
+    console.log('1. Go to https://my.telegram.org/apps');
+    console.log('2. Log in with your phone number');
+    console.log('3. Create a new application (if you haven\'t already)');
+    console.log('4. Copy the api_id and api_hash\n');
+    const apiIdStr = await prompt('Enter your API ID: ');
+    const apiId = parseInt(apiIdStr, 10);
+    if (isNaN(apiId)) {
+        throw new Error('Invalid API ID');
+    }
+    const apiHash = await prompt('Enter your API Hash: ');
+    if (!apiHash) {
+        throw new Error('Invalid API Hash');
+    }
+    // Save credentials
+    setCredentials(apiId, apiHash);
+    console.log('\nConnecting to Telegram...');
+    const session = new StringSession('');
+    const client = new TelegramClient(session, apiId, apiHash, {
+        connectionRetries: 5,
+    });
+    await client.start({
+        phoneNumber: async () => await prompt('Enter your phone number (with country code, e.g., +1234567890): '),
+        password: async () => await prompt('Enter your 2FA password (press Enter if none): '),
+        phoneCode: async () => await prompt('Enter the code you received: '),
+        onError: (err) => console.error('Error:', err),
+    });
+    // Save session
+    const sessionString = client.session.save();
+    setSessionString(sessionString);
+    console.log('\nAuthentication successful! Session saved.');
+    return client;
+}
+export async function checkAuth(client) {
+    try {
+        await client.connect();
+        return await client.isUserAuthorized();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,63 @@
+import { TelegramClient, Api } from 'telegram';
+export declare function getClient(): Promise<TelegramClient>;
+export declare function createClient(apiId: number, apiHash: string): Promise<TelegramClient>;
+export declare function saveSession(client: TelegramClient): Promise<void>;
+export declare function disconnectClient(): Promise<void>;
+export declare function getMe(client: TelegramClient): Promise<Api.User>;
+export interface ChatInfo {
+    id: string;
+    title: string;
+    type: 'user' | 'group' | 'supergroup' | 'channel';
+    username?: string;
+    unreadCount: number;
+    lastMessage?: string;
+    lastMessageDate?: Date;
+}
+export declare function getDialogs(client: TelegramClient, limit?: number): Promise<ChatInfo[]>;
+export interface MessageInfo {
+    id: number;
+    date: Date;
+    sender: string;
+    senderId?: string;
+    text: string;
+    replyToMsgId?: number;
+    isOutgoing: boolean;
+}
+export declare function getMessages(client: TelegramClient, chatIdentifier: string, options?: {
+    limit?: number;
+    offsetId?: number;
+    minDate?: Date;
+    maxDate?: Date;
+}): Promise<{
+    messages: MessageInfo[];
+    chatTitle: string;
+}>;
+export declare function searchMessages(client: TelegramClient, query: string, options?: {
+    chat?: string;
+    limit?: number;
+}): Promise<{
+    messages: MessageInfo[];
+    chatTitle?: string;
+}[]>;
+export declare function sendMessage(client: TelegramClient, chatIdentifier: string, text: string, replyToMsgId?: number): Promise<Api.Message>;
+export declare function getContactInfo(client: TelegramClient, identifier: string): Promise<{
+    id: string;
+    firstName?: string;
+    lastName?: string;
+    username?: string;
+    phone?: string;
+    bio?: string;
+    isBot: boolean;
+    isMutualContact: boolean;
+}>;
+export declare function getChatMembers(client: TelegramClient, chatIdentifier: string, options?: {
+    adminsOnly?: boolean;
+    limit?: number;
+}): Promise<{
+    id: string;
+    name: string;
+    username?: string;
+    isAdmin: boolean;
+}[]>;
+export declare function getAdminGroups(client: TelegramClient): Promise<ChatInfo[]>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}