doclogs-cli 0.1.0__tar.gz → 0.1.2__tar.gz

{doclogs_cli-0.1.0/doclogs_cli.egg-info → doclogs_cli-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doclogs-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: CLI for capturing engineering work and turning it into career artifacts.
 Author: Mridul Tiwari
 License-Expression: MIT
@@ -39,6 +39,8 @@ DocLogs helps you turn day-to-day engineering activity into durable artifacts by
 - generating markdown artifacts for blog posts, LinkedIn, resumes, and interview prep
 - keeping model usage provider-agnostic and safe with sanitization
 
+Use `--syntax` on any command for usage, options, and examples (e.g. `doclog generate --syntax`). Standard `--help` is also available.
+
 ## Core commands
 
 - `doclog capture`
@@ -49,9 +51,14 @@ DocLogs helps you turn day-to-day engineering activity into durable artifacts by
   - surface candidate stories worth expanding
 - `doclog generate <type>`
   - create reusable artifacts such as `blog`, `linkedin`, `resume`, `interview`, or `changelog`
+  - default: saves a sanitized prompt file for manual use in Cursor or Copilot
+  - optional: auto-generate via logged-in Cursor CLI or GitHub Copilot CLI
 - `doclog sanitize`
   - sanitize captured content before any LLM request
   - redact internal URLs, tokens, IP addresses, and other sensitive details
+- `doclog publish`
+  - configure a git repo for publishing generated posts
+  - commit and push a post to that repo
 
 ## Recommended repository structure
 
@@ -85,7 +92,7 @@ For implementation, start by focusing on:
 1. evidence collection and local storage
 2. weekly summaries and story selection
 3. safe prompt generation
-4. provider adapters for OpenAI, Ollama, Anthropic, Gemini, or other APIs
+4. provider adapters for IDE CLIs (Cursor, Copilot) and optional API providers
 
 ## Getting started
 
@@ -120,10 +127,50 @@ doclog capture
 
 ### Daily use
 
-1. Configure `~/.doclog/config.yaml` with your preferred LLM provider (created automatically on first run).
+1. Configure `~/.doclog/config.yaml` (created automatically on first run).
 2. Add a scheduler entry outside the CLI to invoke `doclog capture` at your preferred check-in time.
 3. Capture daily progress and generate reusable career artifacts from the same captured story.
 
+### Generate posts
+
+```bash
+# Default: prompt file only (paste into Cursor/Copilot chat manually)
+doclog weekly
+doclog generate blog -t "nginx fix"
+
+# Auto-generate via logged-in Cursor CLI
+doclog config set provider cursor
+doclog generate blog -t "nginx fix"
+
+# Or Copilot
+doclog config set provider copilot
+
+# Back to prompt-only
+doclog config set provider prompt_only
+
+# Check provider availability
+doclog config
+```
+
+Ensure Cursor/Copilot CLI is installed and authenticated when using those providers (`agent login` or `copilot`).
+
+### Publish a post to git
+
+Point DocLogs at a local clone of your blog/docs repo, then commit and push generated posts:
+
+```bash
+doclog publish set repo ~/projects/my-blog
+doclog publish set branch main
+doclog generate blog -t 1
+doclog publish push --latest
+```
+
+Or push a specific file:
+
+```bash
+doclog publish push ~/.doclog/posts/nginx-fix-blog.md -m "Add nginx TLS post"
+```
+
 ## Publish to PyPI (GitHub Actions)
 
 Publishing runs via GitHub Actions — no local `twine upload` needed.

{doclogs_cli-0.1.0 → doclogs_cli-0.1.2}/README.md

@@ -13,6 +13,8 @@ DocLogs helps you turn day-to-day engineering activity into durable artifacts by
 - generating markdown artifacts for blog posts, LinkedIn, resumes, and interview prep
 - keeping model usage provider-agnostic and safe with sanitization
 
+Use `--syntax` on any command for usage, options, and examples (e.g. `doclog generate --syntax`). Standard `--help` is also available.
+
 ## Core commands
 
 - `doclog capture`
@@ -23,9 +25,14 @@ DocLogs helps you turn day-to-day engineering activity into durable artifacts by
   - surface candidate stories worth expanding
 - `doclog generate <type>`
   - create reusable artifacts such as `blog`, `linkedin`, `resume`, `interview`, or `changelog`
+  - default: saves a sanitized prompt file for manual use in Cursor or Copilot
+  - optional: auto-generate via logged-in Cursor CLI or GitHub Copilot CLI
 - `doclog sanitize`
   - sanitize captured content before any LLM request
   - redact internal URLs, tokens, IP addresses, and other sensitive details
+- `doclog publish`
+  - configure a git repo for publishing generated posts
+  - commit and push a post to that repo
 
 ## Recommended repository structure
 
@@ -59,7 +66,7 @@ For implementation, start by focusing on:
 1. evidence collection and local storage
 2. weekly summaries and story selection
 3. safe prompt generation
-4. provider adapters for OpenAI, Ollama, Anthropic, Gemini, or other APIs
+4. provider adapters for IDE CLIs (Cursor, Copilot) and optional API providers
 
 ## Getting started
 
@@ -94,10 +101,50 @@ doclog capture
 
 ### Daily use
 
-1. Configure `~/.doclog/config.yaml` with your preferred LLM provider (created automatically on first run).
+1. Configure `~/.doclog/config.yaml` (created automatically on first run).
 2. Add a scheduler entry outside the CLI to invoke `doclog capture` at your preferred check-in time.
 3. Capture daily progress and generate reusable career artifacts from the same captured story.
 
+### Generate posts
+
+```bash
+# Default: prompt file only (paste into Cursor/Copilot chat manually)
+doclog weekly
+doclog generate blog -t "nginx fix"
+
+# Auto-generate via logged-in Cursor CLI
+doclog config set provider cursor
+doclog generate blog -t "nginx fix"
+
+# Or Copilot
+doclog config set provider copilot
+
+# Back to prompt-only
+doclog config set provider prompt_only
+
+# Check provider availability
+doclog config
+```
+
+Ensure Cursor/Copilot CLI is installed and authenticated when using those providers (`agent login` or `copilot`).
+
+### Publish a post to git
+
+Point DocLogs at a local clone of your blog/docs repo, then commit and push generated posts:
+
+```bash
+doclog publish set repo ~/projects/my-blog
+doclog publish set branch main
+doclog generate blog -t 1
+doclog publish push --latest
+```
+
+Or push a specific file:
+
+```bash
+doclog publish push ~/.doclog/posts/nginx-fix-blog.md -m "Add nginx TLS post"
+```
+
 ## Publish to PyPI (GitHub Actions)
 
 Publishing runs via GitHub Actions — no local `twine upload` needed.

{doclogs_cli-0.1.0 → doclogs_cli-0.1.2}/commands/capture.py

@@ -5,6 +5,7 @@ from helper.capture import build_capture_entry, merge_notes
 from helper.capture_prompts import iter_interactive_tasks
 from helper.entry import save_entry
 from helper.git_collector import find_git_root
+from helper.syntax import maybe_show_syntax
 
 
 def _print_summary(entry, path) -> None:
@@ -13,15 +14,31 @@ def _print_summary(entry, path) -> None:
     typer.echo(f"   commits today: {len(entry.commits)}")
 
 
+def _notes_with_topic(notes: str, topic: str | None) -> str:
+    if not topic or not topic.strip():
+        return notes
+    topic_line = f"topic: {topic.strip()}"
+    if notes.lstrip().startswith("topic:"):
+        return notes
+    return f"{topic_line}\n{notes}"
+
+
 def register(app: typer.Typer):
 
     @app.command("capture", help="Capture today's engineering work into local storage.")
     def capture(
         notes: Optional[str] = typer.Option(None, "-n", "--notes", help="Optional notes (skips interactive prompts)."),
+        topic: Optional[str] = typer.Option(
+            None,
+            "--topic",
+            help="Short task name (used in weekly review and doclog generate -t).",
+        ),
         no_interactive: bool = typer.Option(False, "--no-interactive", help="Skip questions; git-only capture."),
         include_terminal: bool = typer.Option(False, help="Include optional terminal history evidence."),
         include_tickets: bool = typer.Option(False, help="Include optional ticket IDs or issue references."),
+        syntax: bool = typer.Option(False, "--syntax", help="Show command syntax, options, and examples."),
     ) -> None:
+        maybe_show_syntax("capture", syntax)
         if find_git_root() is None:
             typer.echo("⚠️  Not inside a git repo — git evidence will be empty.")
 
@@ -31,7 +48,7 @@ def register(app: typer.Typer):
             entry = None
             saved_any = False
 
-            for batch, replace in iter_interactive_tasks():
+            for batch, replace in iter_interactive_tasks(topic=topic):
                 entry = build_capture_entry(notes=batch, replace_notes=replace)
                 path = save_entry(entry)
                 saved_any = True
@@ -45,7 +62,7 @@ def register(app: typer.Typer):
             return
 
         # Non-interactive: git only or single --notes
-        final_notes = merge_notes(notes)
+        final_notes = merge_notes(_notes_with_topic(notes, topic) if notes else None)
         entry = build_capture_entry(notes=final_notes)
         path = save_entry(entry)
-        _print_summary(entry, path)
+        _print_summary(entry, path)

doclogs_cli-0.1.2/commands/config.py

@@ -0,0 +1,88 @@
+import typer
+from pathlib import Path
+from typing import Optional
+
+import yaml
+
+from helper.llm import PROVIDER_NAMES, get_provider
+from helper.llm.config import (
+    load_llm_config,
+    load_raw_config,
+    provider_name_from_config,
+    set_llm_provider,
+)
+from helper.paths import ensure_config
+from helper.syntax import maybe_show_syntax
+
+
+def load_config(path: Path | None = None) -> dict[str, object]:
+    config_file = path or ensure_config()
+    if not config_file.exists():
+        raise typer.Exit(code=1, message=f"Config file not found: {config_file}")
+    with config_file.open("r", encoding="utf-8") as stream:
+        return yaml.safe_load(stream) or {}
+
+
+def _show_config(path: Path | None = None) -> None:
+    active = path or ensure_config()
+    settings = load_config(active)
+    provider_name = provider_name_from_config(settings)
+
+    typer.echo(f"Active DocLogs configuration ({active}):")
+    typer.echo(settings)
+    typer.echo("")
+    typer.echo(f"Active provider: {provider_name}")
+    typer.echo(f"Cursor CLI: {_provider_status('cursor')}")
+    typer.echo(f"Copilot CLI: {_provider_status('copilot')}")
+    typer.echo("")
+    typer.echo("Change provider: doclog config set provider cursor|copilot|prompt_only")
+
+
+def _provider_status(name: str) -> str:
+    provider = get_provider(name)
+    if provider.is_available():
+        return "available"
+    return f"not available — {provider.availability_hint()}"
+
+
+def register(app: typer.Typer):
+    config_app = typer.Typer(help="Show or update DocLogs configuration.")
+
+    @config_app.callback(invoke_without_command=True)
+    def config_root(
+        ctx: typer.Context,
+        path: Optional[Path] = typer.Option(None, "-c", "--config", help="Path to the config file."),
+        syntax: bool = typer.Option(False, "--syntax", help="Show command syntax, options, and examples."),
+    ) -> None:
+        if syntax and ctx.invoked_subcommand is None:
+            maybe_show_syntax("config", True)
+        if ctx.invoked_subcommand is not None:
+            return
+        _show_config(path)
+
+    @config_app.command("set", help="Update a configuration value.")
+    def config_set(
+        key: str = typer.Argument(..., help="Setting name (currently: provider)."),
+        value: str = typer.Argument(..., help="New value."),
+        path: Optional[Path] = typer.Option(None, "-c", "--config", help="Path to the config file."),
+        syntax: bool = typer.Option(False, "--syntax", help="Show command syntax, options, and examples."),
+    ) -> None:
+        maybe_show_syntax("config set", syntax)
+        normalized_key = key.strip().lower().replace(".", "_")
+        if normalized_key not in {"provider", "llm_provider"}:
+            typer.echo(f"Unknown setting {key!r}. Supported: provider")
+            raise typer.Exit(code=1)
+
+        try:
+            config_file = set_llm_provider(value, path)
+        except ValueError as exc:
+            typer.echo(str(exc))
+            raise typer.Exit(code=1) from exc
+
+        typer.echo(f"Set llm.provider to {value.strip().lower()} in {config_file}")
+        if value.strip().lower() != "prompt_only":
+            selected = get_provider(value.strip().lower(), load_llm_config(config_file))
+            if not selected.is_available():
+                typer.echo(f"Warning: {selected.availability_hint()}")
+
+    app.add_typer(config_app, name="config")

doclogs_cli-0.1.2/commands/generate.py

@@ -0,0 +1,133 @@
+import re
+
+import typer
+from typing import Optional
+
+from helper.generate import build_prompt, save_and_generate
+from helper.llm import PROVIDER_NAMES, ProviderError, get_provider, resolve_provider_name
+from helper.llm.config import load_llm_config, provider_settings
+from helper.paths import posts_dir
+from helper.story import find_story_text
+from helper.syntax import maybe_show_syntax
+
+
+def slugify(text: str) -> str:
+    text = text.strip().lower()
+    text = re.sub(r"[^\w\s-]", "", text)
+    return re.sub(r"[-\s]+", "-", text).strip("-")
+
+
+def register(app: typer.Typer):
+
+    @app.command("generate", help="Generate a reusable artifact from a captured story.")
+    def generate(
+        artifact_type: str = typer.Argument(..., help="blog, linkedin, resume, interview, changelog"),
+        title: Optional[str] = typer.Option(None, "-t", "--title", help="Story title from doclog weekly."),
+        days: int = typer.Option(7, help="Days back to search for the story."),
+        provider: Optional[str] = typer.Option(
+            None,
+            "--provider",
+            help=f"Override LLM provider: {', '.join(PROVIDER_NAMES)}",
+        ),
+        prompt_only: bool = typer.Option(
+            False,
+            "--prompt-only",
+            help="Write the sanitized prompt file only.",
+        ),
+        force: bool = typer.Option(
+            False,
+            "--force",
+            help="Send to an external provider even when sanitize flags are present.",
+        ),
+        trust: bool = typer.Option(
+            False,
+            "--trust",
+            help="Pass --trust to Cursor CLI (required for non-interactive agent runs).",
+        ),
+        syntax: bool = typer.Option(False, "--syntax", help="Show command syntax, options, and examples."),
+    ) -> None:
+        maybe_show_syntax("generate", syntax)
+        if not title:
+            typer.echo('Pass a story title: doclog generate blog -t "Phase 0 completed"')
+            raise typer.Exit(code=1)
+
+        story = find_story_text(title, days=days)
+        if not story:
+            typer.echo(f"Story not found: {title!r}")
+            typer.echo("Run doclog weekly to see available titles.")
+            typer.echo('Tip: use the list number, e.g. doclog generate blog -t 1')
+            typer.echo('     or a short unique phrase (do not include the date in parentheses)')
+            raise typer.Exit(code=1)
+
+        config = load_llm_config()
+        if trust:
+            config = dict(config)
+            cursor_cfg = dict(provider_settings(config, "cursor"))
+            cursor_cfg["trust_workspace"] = True
+            config["cursor"] = cursor_cfg
+        try:
+            provider_name = resolve_provider_name(
+                provider,
+                prompt_only=prompt_only,
+                config=config,
+            )
+            selected_provider = get_provider(provider_name, config)
+        except ValueError as exc:
+            typer.echo(str(exc))
+            raise typer.Exit(code=1) from exc
+
+        if provider_name != "prompt_only" and not selected_provider.is_available():
+            typer.echo(f"Provider {provider_name!r} is not available.")
+            typer.echo(selected_provider.availability_hint())
+            raise typer.Exit(code=1)
+
+        prompt, findings, flags = build_prompt(artifact_type, story)
+
+        if flags:
+            typer.echo("Sensitive patterns flagged — review before sending to an external provider:")
+            for flag in flags:
+                typer.echo(f"  - [{flag.kind}] {flag.matched[:60]}")
+            if provider_name != "prompt_only" and not force:
+                slug = slugify(title)
+                output_dir = posts_dir()
+                output_dir.mkdir(parents=True, exist_ok=True)
+                prompt_path = output_dir / f"{slug}-{artifact_type}-prompt.md"
+                prompt_path.write_text(prompt, encoding="utf-8")
+                typer.echo("Re-run with --force to send this prompt to the selected provider.")
+                typer.echo(f"Prompt saved to {prompt_path}")
+                raise typer.Exit(code=1)
+
+        slug = slugify(title)
+        output_dir = posts_dir()
+        output_dir.mkdir(parents=True, exist_ok=True)
+
+        if provider_name == "prompt_only":
+            prompt_path = output_dir / f"{slug}-{artifact_type}.md"
+            artifact_path = None
+        else:
+            prompt_path = output_dir / f"{slug}-{artifact_type}-prompt.md"
+            artifact_path = output_dir / f"{slug}-{artifact_type}.md"
+
+        try:
+            result = save_and_generate(
+                prompt,
+                findings,
+                flags,
+                selected_provider,
+                prompt_path=prompt_path,
+                artifact_path=artifact_path,
+            )
+        except ProviderError as exc:
+            prompt_path.write_text(prompt, encoding="utf-8")
+            typer.echo(str(exc))
+            typer.echo(f"Prompt saved to {prompt_path}")
+            raise typer.Exit(code=1) from exc
+
+        if provider_name == "prompt_only":
+            typer.echo(f"Prompt saved to {result.prompt_path}")
+        else:
+            typer.echo(f"Prompt saved to {result.prompt_path}")
+            typer.echo(f"Artifact saved to {result.artifact_path} (provider: {provider_name})")
+
+        if findings:
+            typer.echo(f"   ({len(findings)} item(s) redacted in evidence)")

doclogs_cli-0.1.2/commands/publish.py

@@ -0,0 +1,89 @@
+import typer
+from pathlib import Path
+from typing import Optional
+
+from helper.publish_git import (
+    PUBLISH_KEYS,
+    PublishError,
+    load_publish_config,
+    push_post,
+    resolve_post_file,
+    set_publish_value,
+)
+from helper.syntax import maybe_show_syntax
+
+
+def _show_publish_config() -> None:
+    config = load_publish_config()
+    typer.echo("Publish configuration:")
+    typer.echo(f"  repo:   {config.repo_path or '(not set)'}")
+    typer.echo(f"  branch: {config.branch}")
+    typer.echo(f"  remote: {config.remote}")
+    typer.echo(f"  subdir: {config.subdir}")
+    typer.echo("")
+    typer.echo("Configure: doclog publish set repo /path/to/clone")
+    typer.echo("Push post: doclog publish push --latest")
+
+
+def register(app: typer.Typer):
+    publish_app = typer.Typer(help="Configure and push generated posts to a git repo.")
+
+    @publish_app.callback(invoke_without_command=True)
+    def publish_root(
+        ctx: typer.Context,
+        syntax: bool = typer.Option(False, "--syntax", help="Show command syntax, options, and examples."),
+    ) -> None:
+        if syntax and ctx.invoked_subcommand is None:
+            maybe_show_syntax("publish", True)
+        if ctx.invoked_subcommand is not None:
+            return
+        _show_publish_config()
+
+    @publish_app.command("set", help="Configure the git repo used to publish posts.")
+    def publish_set(
+        key: str = typer.Argument(..., help=f"One of: {', '.join(sorted(PUBLISH_KEYS))}"),
+        value: str = typer.Argument(..., help="Setting value."),
+        syntax: bool = typer.Option(False, "--syntax", help="Show command syntax, options, and examples."),
+    ) -> None:
+        maybe_show_syntax("publish set", syntax)
+        try:
+            config_file = set_publish_value(key, value)
+        except ValueError as exc:
+            typer.echo(str(exc))
+            raise typer.Exit(code=1) from exc
+
+        typer.echo(f"Set publish.{key.strip().lower()} in {config_file}")
+
+    @publish_app.command("push", help="Copy a post into the publish repo, commit, and push.")
+    def publish_push(
+        post: Optional[Path] = typer.Argument(
+            None,
+            help="Path to a generated post under ~/.doclog/posts/",
+        ),
+        latest: bool = typer.Option(
+            False,
+            "--latest",
+            "-l",
+            help="Publish the most recently generated post.",
+        ),
+        message: Optional[str] = typer.Option(
+            None,
+            "-m",
+            "--message",
+            help="Custom git commit message.",
+        ),
+        syntax: bool = typer.Option(False, "--syntax", help="Show command syntax, options, and examples."),
+    ) -> None:
+        maybe_show_syntax("publish push", syntax)
+        try:
+            post_file = resolve_post_file(post, latest=latest)
+            dest = push_post(post_file, load_publish_config(), message=message)
+        except PublishError as exc:
+            typer.echo(str(exc))
+            raise typer.Exit(code=1) from exc
+
+        typer.echo(f"Published {post_file.name}")
+        typer.echo(f"  copied to {dest}")
+        typer.echo(f"  pushed to remote")
+
+    app.add_typer(publish_app, name="publish")

{doclogs_cli-0.1.0 → doclogs_cli-0.1.2}/commands/sanitize.py

@@ -3,6 +3,7 @@ from typing import *
 
 from helper.entry import entry_path_for, load_entry
 from helper.sanitize import redact, sanitize_with_review, text_from_entry
+from helper.syntax import maybe_show_syntax
 
 
 def register(app: typer.Typer):
@@ -10,7 +11,9 @@ def register(app: typer.Typer):
     @app.command("sanitize",  help="Sanitize content before sending to an LLM.")
     def sanitize(
         source: Optional[str] = typer.Argument(None, help="Text to sanitize. If omitted, uses today's capture."),
+        syntax: bool = typer.Option(False, "--syntax", help="Show command syntax, options, and examples."),
     ) -> None:
+        maybe_show_syntax("sanitize", syntax)
         if source:
             text = source
         else:

{doclogs_cli-0.1.0 → doclogs_cli-0.1.2}/commands/weekly.py

@@ -2,6 +2,7 @@ from ast import Return
 import typer
 from typing import *
 from helper.weekly import build_story_candidates, load_entries_for_days
+from helper.syntax import maybe_show_syntax
 
 
 def register(app: typer.Typer):
@@ -9,9 +10,11 @@ def register(app: typer.Typer):
     @app.command("weekly", help="run workflows")
     def weekly(
         limit: int = typer.Option(5, help="Maximum number of story candidates to display."),
-        days: int = typer.Option(7, help="How many days back to review.")
+        days: int = typer.Option(7, help="How many days back to review."),
+        syntax: bool = typer.Option(False, "--syntax", help="Show command syntax, options, and examples."),
         ) -> None:
         """Summarize the week and surface candidate stories for expansion."""
+        maybe_show_syntax("weekly", syntax)
         entries = load_entries_for_days(days)
         if not entries:
             typer.echo(f"📅 No captures found in the last {days} days.")
@@ -25,3 +28,5 @@ def register(app: typer.Typer):
             return
         for i, story in enumerate(candidates, start=1):
             typer.echo(f"{i}. [{story.source}] {story.title} ({story.date})")
+        typer.echo("")
+        typer.echo('Generate: doclog generate blog -t 1   (or a short unique phrase from the title)')

{doclogs_cli-0.1.0 → doclogs_cli-0.1.2/doclogs_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: doclogs-cli
-Version: 0.1.0
+Version: 0.1.2
 Summary: CLI for capturing engineering work and turning it into career artifacts.
 Author: Mridul Tiwari
 License-Expression: MIT
@@ -39,6 +39,8 @@ DocLogs helps you turn day-to-day engineering activity into durable artifacts by
 - generating markdown artifacts for blog posts, LinkedIn, resumes, and interview prep
 - keeping model usage provider-agnostic and safe with sanitization
 
+Use `--syntax` on any command for usage, options, and examples (e.g. `doclog generate --syntax`). Standard `--help` is also available.
+
 ## Core commands
 
 - `doclog capture`
@@ -49,9 +51,14 @@ DocLogs helps you turn day-to-day engineering activity into durable artifacts by
   - surface candidate stories worth expanding
 - `doclog generate <type>`
   - create reusable artifacts such as `blog`, `linkedin`, `resume`, `interview`, or `changelog`
+  - default: saves a sanitized prompt file for manual use in Cursor or Copilot
+  - optional: auto-generate via logged-in Cursor CLI or GitHub Copilot CLI
 - `doclog sanitize`
   - sanitize captured content before any LLM request
   - redact internal URLs, tokens, IP addresses, and other sensitive details
+- `doclog publish`
+  - configure a git repo for publishing generated posts
+  - commit and push a post to that repo
 
 ## Recommended repository structure
 
@@ -85,7 +92,7 @@ For implementation, start by focusing on:
 1. evidence collection and local storage
 2. weekly summaries and story selection
 3. safe prompt generation
-4. provider adapters for OpenAI, Ollama, Anthropic, Gemini, or other APIs
+4. provider adapters for IDE CLIs (Cursor, Copilot) and optional API providers
 
 ## Getting started
 
@@ -120,10 +127,50 @@ doclog capture
 
 ### Daily use
 
-1. Configure `~/.doclog/config.yaml` with your preferred LLM provider (created automatically on first run).
+1. Configure `~/.doclog/config.yaml` (created automatically on first run).
 2. Add a scheduler entry outside the CLI to invoke `doclog capture` at your preferred check-in time.
 3. Capture daily progress and generate reusable career artifacts from the same captured story.
 
+### Generate posts
+
+```bash
+# Default: prompt file only (paste into Cursor/Copilot chat manually)
+doclog weekly
+doclog generate blog -t "nginx fix"
+
+# Auto-generate via logged-in Cursor CLI
+doclog config set provider cursor
+doclog generate blog -t "nginx fix"
+
+# Or Copilot
+doclog config set provider copilot
+
+# Back to prompt-only
+doclog config set provider prompt_only
+
+# Check provider availability
+doclog config
+```
+
+Ensure Cursor/Copilot CLI is installed and authenticated when using those providers (`agent login` or `copilot`).
+
+### Publish a post to git
+
+Point DocLogs at a local clone of your blog/docs repo, then commit and push generated posts:
+
+```bash
+doclog publish set repo ~/projects/my-blog
+doclog publish set branch main
+doclog generate blog -t 1
+doclog publish push --latest
+```
+
+Or push a specific file:
+
+```bash
+doclog publish push ~/.doclog/posts/nginx-fix-blog.md -m "Add nginx TLS post"
+```
+
 ## Publish to PyPI (GitHub Actions)
 
 Publishing runs via GitHub Actions — no local `twine upload` needed.