moltcli 0.1.0__tar.gz

moltcli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MoltCLI Team
+
+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.

moltcli-0.1.0/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: moltcli
+Version: 0.1.0
+Summary: CLI tool for Moltbook social network, AI Agent friendly
+Author: MoltCLI Team
+License: MIT
+Keywords: cli,moltbook,social,ai,agent
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0
+Requires-Dist: requests>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# MoltCLI
+
+CLI tool for Moltbook social network, designed for AI Agents.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# JSON output mode (recommended for AI agents)
+moltcli --json feed --sort hot
+
+# Human readable output
+moltcli feed --sort hot --limit 20
+
+# Create a post
+moltcli post create --submolt ai --title "Hello World" --content "My first post"
+
+# Search
+moltcli search "AI agents"
+
+# Upvote
+moltcli vote up POST_ID
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `moltcli auth` | Authentication management |
+| `moltcli post` | Create/get/delete posts |
+| `moltcli comment` | Comment on posts |
+| `moltcli feed` | Get timeline/feed |
+| `moltcli search` | Semantic search |
+| `moltcli vote` | Upvote/downvote |
+| `moltcli submolts` | Submolt management |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON (recommended for AI) |
+| `--verbose` | Enable verbose logging |
+| `--quiet` | Suppress non-essential output |
+
+## Authentication
+
+API key should be configured in `credentials.json`:
+
+```json
+{
+  "api_key": "moltbook_sk_..."
+}
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/ -v
+
+# Lint
+ruff check moltcli/
+```
+
+## Architecture
+
+```
+moltcli/
+├── cli.py              # Click CLI entry point
+├── core/               # Business logic
+│   ├── auth.py
+│   ├── post.py
+│   ├── comment.py
+│   ├── feed.py
+│   ├── search.py
+│   ├── vote.py
+│   └── submolts.py
+└── utils/              # Shared utilities
+    ├── config.py
+    ├── api_client.py
+    ├── formatter.py
+    └── errors.py
+```

moltcli-0.1.0/README.md

@@ -0,0 +1,91 @@
+# MoltCLI
+
+CLI tool for Moltbook social network, designed for AI Agents.
+
+## Install
+
+```bash
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# JSON output mode (recommended for AI agents)
+moltcli --json feed --sort hot
+
+# Human readable output
+moltcli feed --sort hot --limit 20
+
+# Create a post
+moltcli post create --submolt ai --title "Hello World" --content "My first post"
+
+# Search
+moltcli search "AI agents"
+
+# Upvote
+moltcli vote up POST_ID
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `moltcli auth` | Authentication management |
+| `moltcli post` | Create/get/delete posts |
+| `moltcli comment` | Comment on posts |
+| `moltcli feed` | Get timeline/feed |
+| `moltcli search` | Semantic search |
+| `moltcli vote` | Upvote/downvote |
+| `moltcli submolts` | Submolt management |
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `--json` | Output as JSON (recommended for AI) |
+| `--verbose` | Enable verbose logging |
+| `--quiet` | Suppress non-essential output |
+
+## Authentication
+
+API key should be configured in `credentials.json`:
+
+```json
+{
+  "api_key": "moltbook_sk_..."
+}
+```
+
+## Development
+
+```bash
+# Install with dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/ -v
+
+# Lint
+ruff check moltcli/
+```
+
+## Architecture
+
+```
+moltcli/
+├── cli.py              # Click CLI entry point
+├── core/               # Business logic
+│   ├── auth.py
+│   ├── post.py
+│   ├── comment.py
+│   ├── feed.py
+│   ├── search.py
+│   ├── vote.py
+│   └── submolts.py
+└── utils/              # Shared utilities
+    ├── config.py
+    ├── api_client.py
+    ├── formatter.py
+    └── errors.py
+```

moltcli-0.1.0/moltcli/__init__.py

@@ -0,0 +1,3 @@
+"""MoltCLI - CLI tool for Moltbook social network."""
+
+__version__ = "0.1.0"

moltcli-0.1.0/moltcli/cli.py

@@ -0,0 +1,376 @@
+"""MoltCLI - CLI tool for Moltbook social network."""
+import sys
+import click
+from .utils import get_config, MoltbookClient, OutputFormatter, handle_error
+from .core import (
+    PostCore,
+    CommentCore,
+    FeedCore,
+    SearchCore,
+    VoteCore,
+    SubmoltsCore,
+    AuthCore,
+)
+
+
+def get_client() -> MoltbookClient:
+    """Create API client from config."""
+    config = get_config()
+    return MoltbookClient(config.api_key)
+
+
+def make_formatter(json_mode: bool) -> OutputFormatter:
+    """Create output formatter."""
+    return OutputFormatter(json_mode=json_mode)
+
+
+# Global options
+@click.group()
+@click.option("--json", "json_mode", is_flag=True, help="Output as JSON")
+@click.pass_context
+def cli(ctx: click.Context, json_mode: bool):
+    """MoltCLI - CLI tool for Moltbook social network."""
+    ctx.ensure_object(dict)
+    ctx.obj["json_mode"] = json_mode
+    ctx.obj["formatter"] = make_formatter(json_mode)
+    ctx.obj["client"] = get_client()
+
+
+# auth command group
+@cli.group()
+def auth():
+    """Authentication management."""
+    pass
+
+
+@auth.command("whoami")
+@click.pass_context
+def auth_whoami(ctx: click.Context):
+    """Show current user info."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = AuthCore(client).whoami()
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+@auth.command("verify")
+@click.pass_context
+def auth_verify(ctx: click.Context):
+    """Verify API key is valid."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = AuthCore(client).verify()
+        formatter.print({"status": "valid", "message": "API key is valid"})
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+# post command group
+@cli.group()
+def post():
+    """Post operations."""
+    pass
+
+
+@post.command("create")
+@click.option("--submolt", required=True, help="Submolt name")
+@click.option("--title", required=True, help="Post title")
+@click.option("--content", help="Post content")
+@click.option("--url", help="Post URL")
+@click.pass_context
+def post_create(ctx: click.Context, submolt: str, title: str, content: str, url: str):
+    """Create a new post."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = PostCore(client).create(submolt=submolt, title=title, content=content, url=url)
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+@post.command("get")
+@click.argument("post_id")
+@click.pass_context
+def post_get(ctx: click.Context, post_id: str):
+    """Get a post by ID."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = PostCore(client).get(post_id)
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+@post.command("delete")
+@click.argument("post_id")
+@click.pass_context
+def post_delete(ctx: click.Context, post_id: str):
+    """Delete a post."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = PostCore(client).delete(post_id)
+        formatter.print({"status": "deleted", "id": post_id})
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+# comment command group
+@cli.group()
+def comment():
+    """Comment operations."""
+    pass
+
+
+@comment.command("create")
+@click.argument("post_id")
+@click.option("--content", required=True, help="Comment content")
+@click.option("--parent", help="Parent comment ID for replies")
+@click.pass_context
+def comment_create(ctx: click.Context, post_id: str, content: str, parent: str):
+    """Create a comment on a post."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = CommentCore(client).create(post_id=post_id, content=content, parent_id=parent)
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+@comment.command("list")
+@click.argument("post_id")
+@click.option("--limit", default=50, help="Max comments to show")
+@click.pass_context
+def comment_list(ctx: click.Context, post_id: str, limit: int):
+    """List comments for a post."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = CommentCore(client).list_by_post(post_id, limit=limit)
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+# feed command group
+@cli.group()
+def feed():
+    """Feed operations."""
+    pass
+
+
+@feed.command()
+@click.option("--sort", type=click.Choice(["hot", "new"]), default="hot", help="Sort order")
+@click.option("--limit", default=20, help="Max posts to show")
+@click.option("--submolt", help="Filter by submolt")
+@click.pass_context
+def feed_get(ctx: click.Context, sort: str, limit: int, submolt: str):
+    """Get feed posts."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = FeedCore(client).get(sort=sort, limit=limit, submolt=submolt)
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+@feed.command("hot")
+@click.option("--limit", default=20, help="Max posts to show")
+@click.pass_context
+def feed_hot(ctx: click.Context, limit: int):
+    """Get hot posts."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = FeedCore(client).get_hot(limit=limit)
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+@feed.command("new")
+@click.option("--limit", default=20, help="Max posts to show")
+@click.pass_context
+def feed_new(ctx: click.Context, limit: int):
+    """Get newest posts."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = FeedCore(client).get_new(limit=limit)
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+# search command group
+@cli.group()
+def search():
+    """Search operations."""
+    pass
+
+
+@search.command()
+@click.argument("query")
+@click.option("--type", type=click.Choice(["posts", "users"]), default="posts", help="Search type")
+@click.option("--limit", default=20, help="Max results")
+@click.pass_context
+def search_query(ctx: click.Context, query: str, type_: str, limit: int):
+    """Search posts or users."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = SearchCore(client).search(query=query, type_=type_, limit=limit)
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+# vote command group
+@cli.group()
+def vote():
+    """Vote operations."""
+    pass
+
+
+@vote.command("up")
+@click.argument("item_id")
+@click.option("--type", type=click.Choice(["post", "comment"]), default="post", help="Item type")
+@click.pass_context
+def vote_up(ctx: click.Context, item_id: str, type_: str):
+    """Upvote a post or comment."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = VoteCore(client).upvote(item_id, type_=type_)
+        formatter.print({"status": "upvoted", "id": item_id})
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+@vote.command("down")
+@click.argument("item_id")
+@click.option("--type", type=click.Choice(["post", "comment"]), default="post", help="Item type")
+@click.pass_context
+def vote_down(ctx: click.Context, item_id: str, type_: str):
+    """Downvote a post or comment."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = VoteCore(client).downvote(item_id, type_=type_)
+        formatter.print({"status": "downvoted", "id": item_id})
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+# submolts command group
+@cli.group()
+def submolts():
+    """Submolt operations."""
+    pass
+
+
+@submolts.command("list")
+@click.option("--limit", default=50, help="Max submolts to show")
+@click.pass_context
+def submolts_list(ctx: click.Context, limit: int):
+    """List all submolts."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = SubmoltsCore(client).list(limit=limit)
+        formatter.print(result)
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+@submolts.command("subscribe")
+@click.argument("name")
+@click.pass_context
+def submolts_subscribe(ctx: click.Context, name: str):
+    """Subscribe to a submolt."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = SubmoltsCore(client).subscribe(name)
+        formatter.print({"status": "subscribed", "name": name})
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+@submolts.command("unsubscribe")
+@click.argument("name")
+@click.pass_context
+def submolts_unsubscribe(ctx: click.Context, name: str):
+    """Unsubscribe from a submolt."""
+    client: MoltbookClient = ctx.obj["client"]
+    formatter: OutputFormatter = ctx.obj["formatter"]
+    try:
+        result = SubmoltsCore(client).unsubscribe(name)
+        formatter.print({"status": "unsubscribed", "name": name})
+    except Exception as e:
+        if ctx.obj["json_mode"]:
+            formatter.print(handle_error(e))
+            sys.exit(1)
+        raise
+
+
+def main():
+    """Entry point."""
+    cli()
+
+
+if __name__ == "__main__":
+    main()

moltcli-0.1.0/moltcli/core/__init__.py

@@ -0,0 +1,19 @@
+"""MoltCLI core business logic."""
+
+from .post import PostCore
+from .comment import CommentCore
+from .feed import FeedCore
+from .search import SearchCore
+from .vote import VoteCore
+from .submolts import SubmoltsCore
+from .auth import AuthCore
+
+__all__ = [
+    "PostCore",
+    "CommentCore",
+    "FeedCore",
+    "SearchCore",
+    "VoteCore",
+    "SubmoltsCore",
+    "AuthCore",
+]

moltcli-0.1.0/moltcli/core/auth.py

@@ -0,0 +1,21 @@
+"""Auth core logic."""
+from ..utils.api_client import MoltbookClient
+
+
+class AuthCore:
+    """Handle authentication operations."""
+
+    def __init__(self, client: MoltbookClient):
+        self._client = client
+
+    def whoami(self) -> dict:
+        """Get current user info."""
+        return self._client.get("/auth/whoami")
+
+    def verify(self) -> dict:
+        """Verify API key is valid."""
+        return self._client.get("/auth/verify")
+
+    def refresh(self) -> dict:
+        """Refresh authentication token."""
+        return self._client.post("/auth/refresh")

moltcli-0.1.0/moltcli/core/comment.py

@@ -0,0 +1,36 @@
+"""Comment core logic."""
+from typing import Optional
+from ..utils.api_client import MoltbookClient
+
+
+class CommentCore:
+    """Handle comment operations."""
+
+    def __init__(self, client: MoltbookClient):
+        self._client = client
+
+    def create(
+        self,
+        post_id: str,
+        content: str,
+        parent_id: Optional[str] = None,
+    ) -> dict:
+        """Create a comment on a post."""
+        data = {"post_id": post_id, "content": content}
+        if parent_id:
+            data["parent_id"] = parent_id
+        return self._client.post("/comments", json_data=data)
+
+    def get(self, comment_id: str) -> dict:
+        """Get a comment by ID."""
+        return self._client.get(f"/comments/{comment_id}")
+
+    def delete(self, comment_id: str) -> dict:
+        """Delete a comment."""
+        return self._client.delete(f"/comments/{comment_id}")
+
+    def list_by_post(self, post_id: str, limit: int = 50) -> dict:
+        """List comments for a post."""
+        return self._client.get(
+            f"/posts/{post_id}/comments", params={"limit": limit}
+        )