{"id":48868609,"url":"https://github.com/pocmo/confl","last_synced_at":"2026-04-15T20:11:45.294Z","repository":{"id":332597090,"uuid":"1134227760","full_name":"pocmo/confl","owner":"pocmo","description":"Agent-friendly CLI for Atlassian Confluence Cloud","archived":false,"fork":false,"pushed_at":"2026-02-06T17:46:25.000Z","size":1091,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-07T01:46:01.436Z","etag":null,"topics":["cli","confluence"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pocmo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-01-14T12:35:24.000Z","updated_at":"2026-02-06T17:44:04.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/pocmo/confl","commit_stats":null,"previous_names":["pocmo/confl"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/pocmo/confl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pocmo%2Fconfl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pocmo%2Fconfl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pocmo%2Fconfl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pocmo%2Fconfl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pocmo","download_url":"https://codeload.github.com/pocmo/confl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pocmo%2Fconfl/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31857817,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","confluence"],"created_at":"2026-04-15T20:11:44.807Z","updated_at":"2026-04-15T20:11:45.289Z","avatar_url":"https://github.com/pocmo.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# confl\n\nAn unofficial command-line interface for Atlassian Confluence Cloud.\n\n## What is this?\n\n`confl` is a CLI tool for reading and editing Confluence pages directly from your terminal. It's designed to be scriptable and agent-friendly—no interactive editors by default, just straightforward commands that can be chained and automated.\n\n## Quick Start\n\n```bash\n# Install\npipx install git+https://github.com/pocmo/confl.git\n\n# Authenticate with API token\necho \"$CONFLUENCE_TOKEN\" | confl auth login --token --site yoursite.atlassian.net --email you@example.com\n\n# List pages in a space\nconfl page list --space DEV\n\n# Get a page by ID\nconfl page get \u003cpage-id\u003e\n```\n\n**New to confl?** Check out the [Getting Started Guide](docs/getting-started.md) for a comprehensive walkthrough.\n\n## Installation\n\nInstall with [pipx](https://pipx.pypa.io/) (recommended):\n\n```bash\npipx install git+https://github.com/pocmo/confl.git\n```\n\nSee [Installation Guide](docs/installation.md) for detailed instructions, troubleshooting, and alternative installation methods.\n\n## Authentication\n\n`confl` uses Confluence API tokens for authentication:\n\n```bash\n# Store credentials in config file\necho \"$YOUR_API_TOKEN\" | confl auth login --token \\\n  --site yoursite.atlassian.net \\\n  --email you@example.com\n\n# Check authentication status\nconfl auth status\n```\n\nTo create an API token, visit: https://id.atlassian.com/manage-profile/security/api-tokens\n\nSee [Authentication Guide](docs/authentication.md) for detailed setup, security best practices, and troubleshooting.\n\n## Configuration\n\nConfig lives in `~/.config/confl/credentials.toml`. Environment variables take precedence.\n\n**Multiple profiles:**\n\n```bash\n# Save different environments\necho \"$PROD_TOKEN\" | confl auth login --token --site company.atlassian.net --email you@example.com --profile prod\necho \"$DEV_TOKEN\" | confl auth login --token --site dev.atlassian.net --email dev@example.com --profile dev\n\n# Use a specific profile\nconfl --profile dev page list\n```\n\nSee [Configuration Guide](docs/configuration.md) for details on profiles, environment variables, and global options.\n\n## Commands\n\n`confl` provides commands for managing pages, spaces, attachments, labels, comments, and blog posts.\n\n**Core commands:**\n\n- `confl search` — Search content using CQL or filters\n- `confl page` — Manage pages (list, get, create, update, delete, versions)\n- `confl space` — Manage spaces (list, get)\n- `confl attachment` — Manage attachments (list, upload, download, delete)\n- `confl label` — Manage labels (list, add, remove)\n- `confl comment` — Manage comments (list, get, add, update, delete)\n- `confl blogpost` — Manage blog posts (list, get, create, update, delete)\n- `confl auth` — Manage authentication (login, logout, status, list profiles)\n\n**Quick examples:**\n\n```bash\n# Search for content\nconfl search --text \"API docs\" --space DEV\n\n# Get a page as markdown\nconfl page get 123456 --markdown\n\n# Create a page from markdown\nconfl page create --space DEV --title \"New Page\" --body-file doc.md\n\n# Add a comment\nconfl comment add --page 123456 --body \"Great work!\"\n\n# Upload an attachment\nconfl attachment upload --page 123456 --file report.pdf\n```\n\nSee [Commands Reference](docs/commands.md) for complete command documentation with all options and examples.\n\n## Documentation\n\n- [Getting Started Guide](docs/getting-started.md) — Step-by-step walkthrough for new users\n- [Installation Guide](docs/installation.md) — Installation, upgrading, and troubleshooting\n- [Authentication Guide](docs/authentication.md) — API token setup and security best practices\n- [Configuration Guide](docs/configuration.md) — Profiles, environment variables, and global options\n- [Commands Reference](docs/commands.md) — Complete command documentation\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues or pull requests.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpocmo%2Fconfl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpocmo%2Fconfl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpocmo%2Fconfl/lists"}