Add documentation for the Cielo Home integration #42477

ihsan-cielo · 2025-12-09T14:22:13Z

Proposed change

This PR adds documentation for the new Cielo Home integration.
It includes integration setup instructions, configuration details, high-level description, and removal instructions of the integration.

Type of change

Spelling, grammar or other readability improvements (current branch).
Adjusted missing or incorrect information in the current documentation (current branch).
Added documentation for a new integration I'm adding to Home Assistant (next branch).
- I've opened up a PR to add logos and icons in Brands repository.
Added documentation for a new feature I'm adding to Home Assistant (next branch).
Removed stale or deprecated documentation.

Additional information

Link to parent pull request in the codebase: Add Cielo Home integration core#158511
Link to parent pull request in the Brands repository: Adding cielo_home brand assets brands#8625
This PR fixes or closes issue: fixes # N/A

Checklist

This PR uses the correct branch, based on one of the following:
- I made a change to the existing documentation and used the current branch.
- I made a change that is related to an upcoming version of Home Assistant and used the next branch.
The documentation follows the Home Assistant documentation standards.

home-assistant · 2025-12-09T14:22:19Z

It seems that this PR is targeted against an incorrect branch. Documentation updates which apply to our current stable release should target the current branch. Please change the target branch of this PR to current and rebase if needed. If this is documentation for a new feature, please add a link to that PR in your description.

netlify · 2025-12-09T14:22:21Z

✅ Deploy Preview for home-assistant-docs ready!

Name	Link
🔨 Latest commit	`6d57ef6`
🔍 Latest deploy log	https://app.netlify.com/projects/home-assistant-docs/deploys/693a64d05be06200089b2c01
😎 Deploy Preview	https://deploy-preview-42477--home-assistant-docs.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

source/_integrations/cielo_home.markdown

home-assistant · 2025-12-10T05:06:44Z

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

Co-authored-by: c0ffeeca7 <[email protected]>

c0ffeeca7

tiny tweaks

source/_integrations/cielo_home.markdown

Co-authored-by: c0ffeeca7 <[email protected]>

source/_integrations/cielo_home.markdown

Co-authored-by: c0ffeeca7 <[email protected]>

c0ffeeca7

found some more tiny tweaks 🙈

source/_integrations/cielo_home.markdown

Co-authored-by: c0ffeeca7 <[email protected]>

c0ffeeca7

Thank you, @ihsan-cielo 👍

Copilot

Pull request overview

This PR adds comprehensive documentation for the new Cielo Home integration, which enables control of Cielo smart thermostats (mini-split and central HVAC controllers) through Home Assistant using the Cielo Connect cloud API.

Key changes:

New integration documentation following Home Assistant standards for cloud-polling climate devices
Detailed setup instructions including API key generation and security requirements
Complete coverage of supported devices and their climate entity capabilities

Copilot · 2025-12-11T06:44:01Z

source/_integrations/cielo_home.markdown

+ha_quality_scale: bronze
+---
+
+The **Cielo Home** {% term integration %} integration allows you to control [Cielo](https://www.cielowigle.com) devices directly from Home Assistant, using the cloud-based **Cielo Connect API**.


Remove the redundant word "integration" after the glossary term. The line currently reads "The Cielo Home {% term integration %} integration allows..." which is redundant. It should be "The Cielo Home {% term integration %} allows..." or "The Cielo Home integration allows..."

Suggested change

The **Cielo Home** {% term integration %} integration allows you to control [Cielo](https://www.cielowigle.com) devices directly from Home Assistant, using the cloud-based **Cielo Connect API**.

The **Cielo Home** {% term integration %} allows you to control [Cielo](https://www.cielowigle.com) devices directly from Home Assistant, using the cloud-based **Cielo Connect API**.

source/_integrations/cielo_home.markdown

Copilot · 2025-12-11T06:44:03Z

source/_integrations/cielo_home.markdown

+**Retrieving API key:** `Device [name of device] not correctly registered with remote on Sensibo cloud.`
+


The heading "Retrieving API key:" appears to be mistakenly copied from another integration (possibly Sensibo, based on the error message). This should be removed as it's not a proper heading and the error message reference doesn't belong here.

Suggested change

**Retrieving API key:** `Device [name of device] not correctly registered with remote on Sensibo cloud.`

Copilot · 2025-12-11T06:44:03Z

source/_integrations/cielo_home.markdown

+**Retrieving API key:** `Device [name of device] not correctly registered with remote on Sensibo cloud.`
+
+1. Visit the [Cielo Web Portal](https://home.cielowigle.com).
+2. Open the Menu by selecting the ☲ icon at the top left side.


According to the documentation standards, avoid using symbols like "☲" in documentation. Instead, use the word "hamburger" or describe it as "menu icon" to ensure readability for all users, including those using screen readers or devices that may not render the symbol correctly.

Suggested change

2. Open the Menu by selecting the ☲ icon at the top left side.

2. Open the Menu by selecting the hamburger menu icon {% icon "mdi:menu" %} at the top left side.

source/_integrations/cielo_home.markdown

Add documentation for the Cielo Home integration

ab83efe

home-assistant bot assigned ihsan-cielo Dec 9, 2025

home-assistant bot added has-parent This PR has a parent PR in another repo in-progress This PR/Issue is currently being worked on needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch next This PR goes into the next branch labels Dec 9, 2025

This was referenced Dec 10, 2025

Add Cielo Home integration home-assistant/core#158511

Draft

Adding cielo_home brand assets home-assistant/brands#8625

Open

Adding ha_release

f818eef

home-assistant bot removed the needs-rebase The PR has been branched of the wrong base branch or targets an incorrect target branch label Dec 10, 2025

home-assistant bot unassigned ihsan-cielo Dec 10, 2025

c0ffeeca7 added the new-integration This PR adds documentation for a new Home Assistant integration label Dec 10, 2025

c0ffeeca7 requested changes Dec 10, 2025

View reviewed changes

home-assistant bot marked this pull request as draft December 10, 2025 05:06

ihsan-cielo and others added 10 commits December 11, 2025 03:33

Removing company link, not required

6b320cb

Co-authored-by: c0ffeeca7 <[email protected]>

Adding Synonyms Prerequisites

9143bfb

Co-authored-by: c0ffeeca7 <[email protected]>

Using bold for only UI keywords

c7fca72

Co-authored-by: c0ffeeca7 <[email protected]>

Improving docs Content

09a5abb

Co-authored-by: c0ffeeca7 <[email protected]>

Improving docs Content

bb8d2c9

Co-authored-by: c0ffeeca7 <[email protected]>

Minor Improving docs Content

6878e09

Co-authored-by: c0ffeeca7 <[email protected]>

Minor Change: Improving docs Content

1e7871a

Co-authored-by: c0ffeeca7 <[email protected]>

Minor Change: Improving docs Content

3e55022

Co-authored-by: c0ffeeca7 <[email protected]>

Minor Change: Adding integration Setting Link

c1eacc9

Co-authored-by: c0ffeeca7 <[email protected]>

Minor Fix: Removing unnecessary bold statements

439e745

ihsan-cielo marked this pull request as ready for review December 11, 2025 02:49

home-assistant bot requested a review from c0ffeeca7 December 11, 2025 02:49

c0ffeeca7 requested changes Dec 11, 2025

View reviewed changes

home-assistant bot marked this pull request as draft December 11, 2025 05:03

Apply suggestions from code review

caed71a

Co-authored-by: c0ffeeca7 <[email protected]>

ihsan-cielo marked this pull request as ready for review December 11, 2025 05:10

home-assistant bot requested a review from c0ffeeca7 December 11, 2025 05:10

c0ffeeca7 reviewed Dec 11, 2025

View reviewed changes

source/_integrations/cielo_home.markdown Outdated Show resolved Hide resolved

c0ffeeca7 reviewed Dec 11, 2025

View reviewed changes

source/_integrations/cielo_home.markdown Show resolved Hide resolved

ihsan-cielo and others added 2 commits December 11, 2025 07:24

Apply suggestions from code review

4f2b4e1

Co-authored-by: c0ffeeca7 <[email protected]>

removing line length limit

c685393

c0ffeeca7 requested changes Dec 11, 2025

View reviewed changes

source/_integrations/cielo_home.markdown Outdated Show resolved Hide resolved

source/_integrations/cielo_home.markdown Outdated Show resolved Hide resolved

home-assistant bot marked this pull request as draft December 11, 2025 06:28

Apply suggestions from code review

6d57ef6

Co-authored-by: c0ffeeca7 <[email protected]>

c0ffeeca7 marked this pull request as ready for review December 11, 2025 06:39

Copilot AI review requested due to automatic review settings December 11, 2025 06:39

home-assistant bot requested a review from c0ffeeca7 December 11, 2025 06:39

c0ffeeca7 approved these changes Dec 11, 2025

View reviewed changes

c0ffeeca7 added the awaits-parent Awaits the merge of an parent PR label Dec 11, 2025

Copilot started reviewing on behalf of c0ffeeca7 December 11, 2025 06:40 View session

c0ffeeca7 removed the in-progress This PR/Issue is currently being worked on label Dec 11, 2025

Copilot AI reviewed Dec 11, 2025

View reviewed changes

	The Cielo Home {% term integration %} integration allows you to control [Cielo](https://www.cielowigle.com) devices directly from Home Assistant, using the cloud-based Cielo Connect API.
	The Cielo Home {% term integration %} allows you to control [Cielo](https://www.cielowigle.com) devices directly from Home Assistant, using the cloud-based Cielo Connect API.

		Retrieving API key: `Device [name of device] not correctly registered with remote on Sensibo cloud.`

	2. Open the Menu by selecting the ☲ icon at the top left side.
	2. Open the Menu by selecting the hamburger menu icon {% icon "mdi:menu" %} at the top left side.

Uh oh!

Add documentation for the Cielo Home integration #42477

Are you sure you want to change the base?

Add documentation for the Cielo Home integration #42477

Conversation

ihsan-cielo commented Dec 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Proposed change

Type of change

Additional information

Checklist

Uh oh!

home-assistant bot commented Dec 9, 2025

Uh oh!

netlify bot commented Dec 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for home-assistant-docs ready!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

home-assistant bot commented Dec 10, 2025

Uh oh!

c0ffeeca7 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

c0ffeeca7 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

c0ffeeca7 left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Dec 11, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

ihsan-cielo commented Dec 9, 2025 •

edited

Loading

netlify bot commented Dec 9, 2025 •

edited

Loading