cometapi-cli 0.1.0__tar.gz → 0.2.0__tar.gz

cometapi_cli-0.2.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,46 @@
+name: Bug Report
+description: Report a bug in CometAPI CLI
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of the bug.
+    validations:
+      required: true
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: How can we reproduce this?
+      placeholder: |
+        1. Run `cometapi ...`
+        2. ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened? Include any error output.
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Version and platform info.
+      placeholder: |
+        - CLI version: (cometapi --version)
+        - Python version:
+        - OS:
+    validations:
+      required: true

cometapi_cli-0.2.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,25 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What problem does this feature solve?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How should this work?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any other approaches you've considered?
+    validations:
+      required: false

cometapi_cli-0.2.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+## Description
+
+<!-- What does this PR do? -->
+
+## Related Issues
+
+<!-- Link related issues: Fixes #123, Closes #456 -->
+
+## Checklist
+
+- [ ] Tests pass (`uv run pytest -v`)
+- [ ] Lint passes (`uv run ruff check src/ tests/`)
+- [ ] CHANGELOG.md updated (if user-facing change)
+- [ ] Documentation updated (if applicable)

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/.github/workflows/publish.yml

@@ -6,7 +6,7 @@ on:
       - "v*"
 
 permissions:
-  contents: read
+  contents: write
   id-token: write
 
 jobs:
@@ -28,3 +28,9 @@ jobs:
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          files: dist/*

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/AGENTS.md

@@ -82,24 +82,36 @@ Package name: `cometapi-cli`. Triggered automatically by pushing a `v*` tag to G
 ### Release SOP
 
 ```bash
-# 1. Bump version in TWO places (must match):
+# 1. Update CHANGELOG.md with the new version section
+
+# 2. Bump version in TWO places (must match):
 #    - pyproject.toml: version = "X.Y.Z"
 #    - src/cometapi_cli/__init__.py: __version__ = "X.Y.Z"
 
-# 2. Commit and push
-git add -A
-git commit -m "release: vX.Y.Z"
+# 3. Merge dev → main
+git checkout main
+git merge dev
 git push origin main
 
-# 3. Tag and push — triggers publish.yml automatically
+# 4. Tag and push — triggers publish.yml automatically
+#    (publishes to PyPI + creates GitHub Release with auto-generated notes)
 git tag vX.Y.Z
 git push origin vX.Y.Z
+
+# 5. Switch back to dev
+git checkout dev
 ```
 
 ### Verify
 
 ```bash
+# Check PyPI
 open https://pypi.org/project/cometapi-cli/
+
+# Check GitHub Release
+open https://github.com/cometapi-dev/cometapi-cli/releases
+
+# Install and test
 pip install cometapi-cli==X.Y.Z
 cometapi --version
 ```

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.2.0] — 2026-04-09
+## [0.2.0] — 2026-04-13
 
 ### Added
 
@@ -18,11 +18,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Config management**: `config show/set/unset/path` subcommands, TOML config at `~/.config/cometapi/config.toml`
 - **Persistent output_format**: set default output format in `config.toml`
 - **Doctor diagnostics**: connectivity, auth, SDK, and config health checks
-- **Setup wizard**: `cometapi init` with API key validation
+- **Setup wizard**: `cometapi init` with API key validation, existing config detection, and reconfiguration flow
 - **Shell completion**: bash, zsh, fish, powershell
 - **Error handling**: structured exit codes (sysexits.h compatible), user-friendly messages
 - **Security**: credential masking, 0600 file permissions, creation URL guidance
-- **CI/CD**: GitHub Actions for testing (Python 3.10–3.13) and PyPI publishing
+- **CI/CD**: GitHub Actions for testing (Python 3.10–3.13), PyPI publishing, and GitHub Releases
 
 ### Changed
 

cometapi_cli-0.2.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,54 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+**support@cometapi.com**.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/),
+version 2.1, available at
+<https://www.contributor-covenant.org/version/2/1/code_of_conduct.html>.

cometapi_cli-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,48 @@
+# Contributing to CometAPI CLI
+
+Thank you for your interest in contributing! Here's how to get started.
+
+## Development Setup
+
+```bash
+git clone https://github.com/cometapi-dev/cometapi-cli.git
+cd cometapi-cli
+uv sync --extra dev
+```
+
+## Making Changes
+
+1. **Fork** the repository and create a feature branch from `main`.
+2. **Write or update tests** for your change.
+3. **Run tests and lint** before submitting:
+   ```bash
+   uv run pytest -v
+   uv run ruff check src/ tests/
+   ```
+4. **Open a pull request** with a clear description of the change.
+
+## Code Style
+
+- Follow [Ruff](https://docs.astral.sh/ruff/) defaults (configured in `pyproject.toml`).
+- Keep the code typed — use type hints for all public functions.
+- All network calls go through `CometClient` — never use raw HTTP in commands.
+
+## Reporting Bugs
+
+Open an issue using the **Bug Report** template. Include:
+- CLI version (`cometapi --version`)
+- Python version
+- OS
+- Steps to reproduce
+
+## Suggesting Features
+
+Open an issue using the **Feature Request** template.
+
+## Code of Conduct
+
+This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md). By participating, you agree to abide by its terms.
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: cometapi-cli
-Version: 0.1.0
+Version: 0.2.0
 Summary: CometAPI CLI — official command-line interface for the CometAPI AI gateway
-Project-URL: Homepage, https://github.com/CometAPI/cometapi-cli
-Project-URL: Repository, https://github.com/CometAPI/cometapi-cli
+Project-URL: Homepage, https://github.com/cometapi-dev/cometapi-cli
+Project-URL: Repository, https://github.com/cometapi-dev/cometapi-cli
 Project-URL: Documentation, https://docs.cometapi.com
-Project-URL: Changelog, https://github.com/CometAPI/cometapi-cli/blob/main/CHANGELOG.md
-Project-URL: Issues, https://github.com/CometAPI/cometapi-cli/issues
+Project-URL: Changelog, https://github.com/cometapi-dev/cometapi-cli/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/cometapi-dev/cometapi-cli/issues
 Author-email: CometAPI <support@cometapi.com>
 License: MIT
 License-File: LICENSE
@@ -164,6 +164,20 @@ cometapi config unset api_key     # Remove a value
 cometapi config path              # Show config file path
 ```
 
+### Examples
+
+```bash
+# Switch default output to JSON (all commands)
+cometapi config set output_format json
+
+# Change default model
+cometapi config set default_model claude-sonnet-4-6
+
+# Override per-command (regardless of config)
+cometapi models --format yaml
+cometapi balance --json
+```
+
 **Priority**: CLI flags > config file > environment variables > defaults
 
 | Key | Env Variable | Description |
@@ -186,7 +200,7 @@ CometAPI CLI is designed to be agent-friendly:
 ## Development
 
 ```bash
-git clone https://github.com/CometAPI/cometapi-cli.git
+git clone https://github.com/cometapi-dev/cometapi-cli.git
 cd cometapi-cli
 uv sync --extra dev
 
@@ -199,7 +213,7 @@ uv run cometapi --version     # verify
 <summary>Without uv (pip)</summary>
 
 ```bash
-git clone https://github.com/CometAPI/cometapi-cli.git
+git clone https://github.com/cometapi-dev/cometapi-cli.git
 cd cometapi-cli
 pip install -e ".[dev]"
 pytest -v
@@ -223,6 +237,14 @@ pytest -v
 | `Connection failed` | Run `cometapi doctor` to diagnose connectivity |
 | `Access token not configured` | Only needed for `account`/`stats` commands — run `cometapi init` to add one |
 
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+
 ## License
 
 MIT

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/README.md

@@ -126,6 +126,20 @@ cometapi config unset api_key     # Remove a value
 cometapi config path              # Show config file path
 ```
 
+### Examples
+
+```bash
+# Switch default output to JSON (all commands)
+cometapi config set output_format json
+
+# Change default model
+cometapi config set default_model claude-sonnet-4-6
+
+# Override per-command (regardless of config)
+cometapi models --format yaml
+cometapi balance --json
+```
+
 **Priority**: CLI flags > config file > environment variables > defaults
 
 | Key | Env Variable | Description |
@@ -148,7 +162,7 @@ CometAPI CLI is designed to be agent-friendly:
 ## Development
 
 ```bash
-git clone https://github.com/CometAPI/cometapi-cli.git
+git clone https://github.com/cometapi-dev/cometapi-cli.git
 cd cometapi-cli
 uv sync --extra dev
 
@@ -161,7 +175,7 @@ uv run cometapi --version     # verify
 <summary>Without uv (pip)</summary>
 
 ```bash
-git clone https://github.com/CometAPI/cometapi-cli.git
+git clone https://github.com/cometapi-dev/cometapi-cli.git
 cd cometapi-cli
 pip install -e ".[dev]"
 pytest -v
@@ -185,6 +199,14 @@ pytest -v
 | `Connection failed` | Run `cometapi doctor` to diagnose connectivity |
 | `Access token not configured` | Only needed for `account`/`stats` commands — run `cometapi init` to add one |
 
+## Contributing
+
+Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+
 ## License
 
 MIT

cometapi_cli-0.2.0/SECURITY.md

@@ -0,0 +1,27 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+|---------|-----------|
+| 0.2.x   | ✅        |
+| < 0.2   | ❌        |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it responsibly:
+
+1. **Do NOT open a public issue.**
+2. Email **support@cometapi.com** with details of the vulnerability.
+3. Include steps to reproduce, if possible.
+
+We will acknowledge receipt within 48 hours and aim to provide a fix or mitigation plan within 7 days.
+
+## Security Practices
+
+- API keys and access tokens are **never** logged or displayed in full — only the last 4 characters are shown.
+- Config files are stored with restrictive permissions (`0600`).
+- Credentials should **never** be committed to version control.
+- Create credentials at:
+  - API Key: https://www.cometapi.com/console/token
+  - Access Token: https://www.cometapi.com/console/personal

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/docs/commands/init.md

@@ -18,14 +18,16 @@ No credentials required — this command sets them up.
 
 ## Wizard Flow
 
-1. **Security notice** — displays a warning about credential handling and links to creation pages.
-2. **API key prompt** — asks for `COMETAPI_KEY`. Shows current value (masked) as default if already configured.
-3. **Connectivity test** — if an API key is provided, tests connectivity by calling `models.list()`.
-4. **Access token prompt** — asks whether to configure `COMETAPI_ACCESS_TOKEN` (optional). Shows current value (masked) as default.
-5. **Default model** — asks for the default model to use with `chat` (default: `gpt-5.4`).
-6. **Save** — writes configuration to `~/.config/cometapi/config.toml` with `0600` permissions.
+1. **Existing config check** — if a config file exists, displays a summary of current settings (secrets masked) and asks whether to continue with reconfiguration. User can abort to keep config unchanged.
+2. **Security notice** — displays a warning about credential handling and links to creation pages.
+3. **API key prompt** — asks for `COMETAPI_KEY`. Shows current value (masked) as default if already configured. Displays `(Enter to keep)` hint when a value exists.
+4. **Connectivity test** — if an API key is provided, tests connectivity by calling `models.list()`.
+5. **Access token prompt** — asks whether to configure `COMETAPI_ACCESS_TOKEN` (optional). Shows current value (masked) as default. Displays `(Enter to keep)` hint when a value exists.
+6. **Default model** — asks for the default model to use with `chat` (default: `gpt-5.4`).
+7. **Default output format** — asks for the default output format (default: `table`).
+8. **Save** — writes configuration to `~/.config/cometapi/config.toml` with `0600` permissions. If no values were changed, skips writing and displays "No changes made."
 
-## Example Session
+## Example Session (First Run)
 
 ```
 🚀 Welcome
@@ -49,6 +51,7 @@ Configure access token? (for account/stats commands) [y/n]: y
 Access Token (COMETAPI_ACCESS_TOKEN): pat-...
 
 Default model [gpt-5.4]: gpt-5.4
+Default output format (table, json, yaml, csv, markdown) [table]: table
 
 ✅ Setup Complete
 Configuration saved to /Users/you/.config/cometapi/config.toml
@@ -62,7 +65,25 @@ Next steps:
 
 ## Re-Running Init
 
-Running `init` again shows current masked values as defaults. Press Enter to keep existing values, or type a new value to replace.
+When a configuration file already exists, `init` displays a summary of current settings and prompts for confirmation before proceeding:
+
+```
+📋 Current Config
+Existing configuration found:
+
+  api_key = ****abcd
+  access_token = ****wxyz
+  default_model = gpt-5.4
+  output_format = table
+
+Press Enter on each prompt to keep the current value.
+
+Continue with reconfiguration? [Y/n]:
+```
+
+- Press **Enter** or **y** to proceed — each prompt shows `(Enter to keep)` so you can skip unchanged fields.
+- Press **n** to abort — config file remains untouched.
+- If you go through all prompts without changing anything, the wizard prints "No changes made" and does not rewrite the file.
 
 ## Credential Links
 

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cometapi-cli"
-version = "0.1.0"
+version = "0.2.0"
 description = "CometAPI CLI — official command-line interface for the CometAPI AI gateway"
 readme = "README.md"
 license = { text = "MIT" }
@@ -40,11 +40,11 @@ dev = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/CometAPI/cometapi-cli"
-Repository = "https://github.com/CometAPI/cometapi-cli"
+Homepage = "https://github.com/cometapi-dev/cometapi-cli"
+Repository = "https://github.com/cometapi-dev/cometapi-cli"
 Documentation = "https://docs.cometapi.com"
-Changelog = "https://github.com/CometAPI/cometapi-cli/blob/main/CHANGELOG.md"
-Issues = "https://github.com/CometAPI/cometapi-cli/issues"
+Changelog = "https://github.com/cometapi-dev/cometapi-cli/blob/main/CHANGELOG.md"
+Issues = "https://github.com/cometapi-dev/cometapi-cli/issues"
 
 [project.scripts]
 cometapi = "cometapi_cli.app:app"

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/__init__.py

@@ -1,3 +1,3 @@
 """CometAPI CLI — professional terminal interface for CometAPI."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/app.py

@@ -33,11 +33,11 @@ def main(
     ctx: typer.Context,
     version: Annotated[
         bool | None,
-        typer.Option("--version", "-V", help="Show version and exit.", callback=_version_callback, is_eager=True),
+        typer.Option("--version", "-V", "-v", help="Show version and exit.", callback=_version_callback, is_eager=True),
     ] = None,
     output_format: Annotated[
         OutputFormat,
-        typer.Option("--format", "-f", help="Output format."),
+        typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown)."),
     ] = OutputFormat.TABLE,
     json_output: Annotated[
         bool,

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/account.py

@@ -14,7 +14,7 @@ from ..formatters import OutputFormat, output, resolve_format
 @handle_errors
 def account(
     ctx: typer.Context,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """Show your CometAPI account profile (requires access token)."""

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/balance.py

@@ -18,7 +18,7 @@ def balance(
         str | None,
         typer.Option("--source", "-s", help="Data source: 'account' (full account) or 'token' (current API key)."),
     ] = None,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """Show your CometAPI account balance.

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/chat.py

@@ -17,12 +17,12 @@ from ..formatters import OutputFormat, resolve_format
 def chat(
     ctx: typer.Context,
     message: Annotated[str | None, typer.Argument(help="Message to send. Omit to enter interactive REPL.")] = None,
-    model: Annotated[str | None, typer.Option("--model", "-m", help="Model to use.")] = None,
+    model: Annotated[str | None, typer.Option("--model", "-m", help="Model to use (default: from config or gpt-5.4).")] = None,
     system: Annotated[str | None, typer.Option("--system", "-s", help="System prompt.")] = None,
-    temperature: Annotated[float | None, typer.Option("--temperature", "-t", help="Sampling temperature.")] = None,
+    temperature: Annotated[float | None, typer.Option("--temperature", "-t", help="Sampling temperature (0.0–2.0).")] = None,
     max_tokens: Annotated[int | None, typer.Option("--max-tokens", help="Max tokens in response.")] = None,
     stream: Annotated[bool, typer.Option("--stream/--no-stream", help="Stream output.")] = True,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """Send a chat message, or start interactive REPL (no args)."""

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/config_cmd.py

@@ -13,7 +13,12 @@ from ..console import console, err_console
 from ..errors import handle_errors
 from ..formatters import OutputFormat, output, resolve_format
 
-config_app = typer.Typer(name="config", help="Manage CLI configuration.")
+config_app = typer.Typer(
+    name="config",
+    help="Manage CLI configuration.",
+    no_args_is_help=True,
+    context_settings={"help_option_names": ["-h", "--help"]},
+)
 
 
 @handle_errors
@@ -31,6 +36,34 @@ def init(ctx: typer.Context) -> None:
         )
     )
 
+    cfg = load_config()
+    has_existing = bool(cfg)
+
+    # Show existing config summary and let user decide
+    if has_existing:
+        summary_lines = []
+        for key in ("api_key", "access_token", "default_model", "output_format", "base_url"):
+            val = cfg.get(key)
+            if val:
+                display = mask_secret(str(val)) if key in ("api_key", "access_token") else val
+                summary_lines.append(f"  [bold]{key}[/bold] = {display}")
+        if summary_lines:
+            console.print(
+                Panel(
+                    "[bold yellow]Existing configuration found:[/bold yellow]\n\n"
+                    + "\n".join(summary_lines)
+                    + "\n\n[dim]Press Enter on each prompt to keep the current value.[/dim]",
+                    title="📋 Current Config",
+                    border_style="yellow",
+                )
+            )
+            if not Confirm.ask(
+                "[bold]Continue with reconfiguration?[/bold]",
+                default=True,
+            ):
+                console.print("[dim]Aborted. Config unchanged.[/dim]")
+                return
+
     console.print(
         Panel(
             "[bold yellow]⚠ Security Notice[/bold yellow]\n\n"
@@ -43,17 +76,19 @@ def init(ctx: typer.Context) -> None:
         )
     )
 
-    cfg = load_config()
+    changed = False
 
     # API Key
     current_key = cfg.get("api_key", "")
     default_display = mask_secret(current_key) if current_key else None
+    hint = " [dim](Enter to keep)[/dim]" if current_key else ""
     api_key = Prompt.ask(
-        "[bold]API Key[/bold] (COMETAPI_KEY)",
+        f"[bold]API Key[/bold] (COMETAPI_KEY){hint}",
         default=default_display,
     )
     if api_key and api_key != default_display:
         cfg["api_key"] = api_key
+        changed = True
 
     # Validate connectivity
     if cfg.get("api_key"):
@@ -75,22 +110,45 @@ def init(ctx: typer.Context) -> None:
         default=bool(current_token),
     ):
         default_token_display = mask_secret(current_token) if current_token else None
+        hint = " [dim](Enter to keep)[/dim]" if current_token else ""
         access_token = Prompt.ask(
-            "[bold]Access Token[/bold] (COMETAPI_ACCESS_TOKEN)",
+            f"[bold]Access Token[/bold] (COMETAPI_ACCESS_TOKEN){hint}",
             default=default_token_display,
         )
         if access_token and access_token != default_token_display:
             cfg["access_token"] = access_token
+            changed = True
 
     # Default model
     console.print()
+    current_model = cfg.get("default_model", "")
+    model_default = current_model or get_default_model()
     default_model = Prompt.ask(
         "[bold]Default model[/bold]",
-        default=cfg.get("default_model", get_default_model()),
+        default=model_default,
+    )
+    if default_model != current_model:
+        cfg["default_model"] = default_model
+        changed = True
+
+    # Default output format
+    console.print()
+    current_format = cfg.get("output_format", "")
+    format_default = current_format or "table"
+    output_format = Prompt.ask(
+        "[bold]Default output format[/bold] (table, json, yaml, csv, markdown)",
+        default=format_default,
     )
-    cfg["default_model"] = default_model
+    if output_format != current_format:
+        cfg["output_format"] = output_format
+        changed = True
 
     # Save
+    if has_existing and not changed:
+        console.print()
+        console.print("[dim]No changes made. Config unchanged.[/dim]")
+        return
+
     save_config(cfg)
 
     console.print()
@@ -113,7 +171,7 @@ def init(ctx: typer.Context) -> None:
 @handle_errors
 def config_show(
     ctx: typer.Context,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """Display current configuration (secrets are masked)."""
@@ -137,10 +195,18 @@ def config_show(
 @config_app.command("set")
 @handle_errors
 def config_set(
-    key: Annotated[str, typer.Argument(help="Configuration key.")],
-    value: Annotated[str, typer.Argument(help="Configuration value.")],
+    key: Annotated[str, typer.Argument(help="Configuration key (api_key, access_token, base_url, default_model, output_format).")],
+    value: Annotated[str, typer.Argument(help="Value to set. For output_format: table, json, yaml, csv, markdown.")],
 ) -> None:
-    """Set a configuration value."""
+    """Set a configuration value.
+
+    Valid keys: api_key, access_token, base_url, default_model, output_format.
+
+    Examples:
+        cometapi config set output_format json
+        cometapi config set default_model claude-sonnet-4-6
+        cometapi config set api_key sk-xxx
+    """
     if key not in VALID_KEYS:
         err_console.print(f"[red bold]Error:[/] Unknown key '{key}'. Valid keys: {', '.join(sorted(VALID_KEYS))}")
         raise typer.Exit(code=2)
@@ -155,7 +221,7 @@ def config_set(
 @config_app.command("unset")
 @handle_errors
 def config_unset(
-    key: Annotated[str, typer.Argument(help="Configuration key to remove.")],
+    key: Annotated[str, typer.Argument(help="Configuration key to remove (api_key, access_token, base_url, default_model, output_format).")],
 ) -> None:
     """Remove a configuration value."""
     cfg = load_config()

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/doctor.py

@@ -25,7 +25,7 @@ def _warn_mark() -> str:
 @handle_errors
 def doctor(
     ctx: typer.Context,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """Check CLI configuration and API connectivity."""

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/logs.py

@@ -162,10 +162,9 @@ def logs(
         str | None,
         typer.Option("--type", help="Filter by type: consume, topup, error, refund, manage, system."),
     ] = None,
-    search: Annotated[str | None, typer.Option("--search", "-s", help="[deprecated] Search logs by keyword.")] = None,
     start: Annotated[str | None, typer.Option("--start", help="Start date (YYYY-MM-DD, ISO 8601, or Unix ts).")] = None,
     end: Annotated[str | None, typer.Option("--end", help="End date (YYYY-MM-DD, ISO 8601, or Unix ts).")] = None,
-    group: Annotated[str | None, typer.Option("--group", "-g", help="Filter by group.")] = None,
+    group: Annotated[str | None, typer.Option("--group", "-g", help="Filter by API key group name.")] = None,
     request_id: Annotated[
         str | None,
         typer.Option("--request-id", help="Look up cost by request ID (X-Cometapi-Request-Id header)."),
@@ -177,7 +176,7 @@ def logs(
     page: Annotated[int, typer.Option("--page", "-p", help="Page number.")] = 1,
     limit: Annotated[int, typer.Option("--limit", "-l", help="Results per page.")] = 20,
     export: Annotated[bool, typer.Option("--export", help="Export logs as CSV to stdout.")] = False,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """Show your usage logs (requires access token)."""
@@ -247,52 +246,24 @@ def logs(
         sys.stdout.buffer.write(csv_bytes)
         return
 
-    if search:
-        err_console.print(
-            "[yellow]Warning:[/] --search only matches log type codes on the server, "
-            "not keywords. Use --request-id, --model, or --token-name for filtering."
-        )
-        ignored = []
-        if model:
-            ignored.append("--model")
-        if token_name:
-            ignored.append("--token-name")
-        if log_type:
-            ignored.append("--type")
-        if start:
-            ignored.append("--start")
-        if end:
-            ignored.append("--end")
-        if group:
-            ignored.append("--group")
-        if page != 1:
-            ignored.append("--page")
-        if limit != 20:
-            ignored.append("--limit")
-        if ignored:
-            err_console.print(
-                f"[yellow]Warning:[/] --search ignores other filters: {', '.join(ignored)}"
-            )
-        resp = client.search_logs(keyword=search)
-    else:
-        type_int = None
-        if log_type:
-            type_int = LOG_TYPE_MAP.get(log_type.lower())
-            if type_int is None:
-                valid = ", ".join(LOG_TYPE_MAP.keys())
-                err_console.print(f"[red]Invalid log type:[/] {log_type}. Valid types: {valid}")
-                raise typer.Exit(code=2)
+    type_int = None
+    if log_type:
+        type_int = LOG_TYPE_MAP.get(log_type.lower())
+        if type_int is None:
+            valid = ", ".join(LOG_TYPE_MAP.keys())
+            err_console.print(f"[red]Invalid log type:[/] {log_type}. Valid types: {valid}")
+            raise typer.Exit(code=2)
 
-        resp = client.list_logs(
-            page=page,
-            page_size=limit,
-            log_type=type_int,
-            model_name=model,
-            token_name=token_name,
-            start_timestamp=start_ts,
-            end_timestamp=end_ts,
-            group=group,
-        )
+    resp = client.list_logs(
+        page=page,
+        page_size=limit,
+        log_type=type_int,
+        model_name=model,
+        token_name=token_name,
+        start_timestamp=start_ts,
+        end_timestamp=end_ts,
+        group=group,
+    )
 
     data = extract_items(resp)
 

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/models.py

@@ -16,7 +16,7 @@ def models(
     ctx: typer.Context,
     search: Annotated[str | None, typer.Option("--search", "-s", help="Filter models by name.")] = None,
     limit: Annotated[int | None, typer.Option("--limit", "-l", help="Max number of models to show.")] = None,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """List available models."""

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/repl.py

@@ -71,7 +71,7 @@ def run_repl() -> None:
     completer = WordCompleter(
         REPL_COMMANDS + [
             "--json", "--format", "--model", "--system",
-            "--search", "--limit", "--help", "--page",
+            "--limit", "--help", "--page",
             "--type", "--token-name", "--start", "--end",
             "--group", "--export", "--platform", "--task-id",
             "--status", "--action",

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/stats.py

@@ -14,7 +14,7 @@ from ..formatters import OutputFormat, output, resolve_format
 @handle_errors
 def stats(
     ctx: typer.Context,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """Show your CometAPI usage statistics (requires access token)."""

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/tasks.py

@@ -61,12 +61,12 @@ def tasks(
         str | None,
         typer.Option("--status", "-s", help=f"Filter by status: {', '.join(VALID_STATUSES)}."),
     ] = None,
-    action: Annotated[str | None, typer.Option("--action", "-a", help="Filter by action type.")] = None,
+    action: Annotated[str | None, typer.Option("--action", "-a", help="Filter by action type (platform-dependent, e.g. generate, upscale, vary).")] = None,
     start: Annotated[str | None, typer.Option("--start", help="Start date (YYYY-MM-DD, ISO 8601, or Unix ts).")] = None,
     end: Annotated[str | None, typer.Option("--end", help="End date (YYYY-MM-DD, ISO 8601, or Unix ts).")] = None,
     page: Annotated[int, typer.Option("--page", help="Page number.")] = 1,
     limit: Annotated[int, typer.Option("--limit", "-l", help="Results per page.")] = 20,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """Show your async task logs — Suno, MJ, Luma, Kling, etc. (requires access token)."""

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/src/cometapi_cli/commands/tokens.py

@@ -46,7 +46,7 @@ def tokens(
     search: Annotated[str | None, typer.Option("--search", "-s", help="Search tokens by name or key.")] = None,
     page: Annotated[int, typer.Option("--page", "-p", help="Page number.")] = 1,
     limit: Annotated[int, typer.Option("--limit", "-l", help="Results per page.")] = 20,
-    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format.")] = None,
+    output_format: Annotated[OutputFormat | None, typer.Option("--format", "-f", help="Output format (table, json, yaml, csv, markdown).")] = None,
     json_output: Annotated[bool, typer.Option("--json", help="Output as JSON.")] = False,
 ) -> None:
     """List and search your API keys (requires access token)."""

{cometapi_cli-0.1.0 → cometapi_cli-0.2.0}/tests/test_logs.py

@@ -61,11 +61,6 @@ class TestLogsTable:
             start_timestamp=None, end_timestamp=None, group=None,
         )
 
-    def test_logs_search(self, cli_runner, patched_client):
-        result = cli_runner("logs", "--search", "claude")
-        assert result.exit_code == 0
-        patched_client.search_logs.assert_called_once_with(keyword="claude")
-
     def test_logs_filter_start_date(self, cli_runner, patched_client):
         result = cli_runner("logs", "--start", "2024-01-15")
         assert result.exit_code == 0
@@ -226,12 +221,3 @@ class TestLogsDetail:
         data = json.loads(result.output)
         assert len(data) == 2
 
-
-class TestLogsSearchDeprecation:
-    """Test --search deprecation warning."""
-
-    def test_logs_search_deprecation_warning(self, cli_runner, patched_client):
-        result = cli_runner("logs", "--search", "anything")
-        assert result.exit_code == 0
-        patched_client.search_logs.assert_called_once_with(keyword="anything")
-        # Warning should still be emitted (may be on stderr).