mcpField
S
setting-up-looker-project

setting-up-looker-project

github.com/looker-open-sourceData & databases43105 installsUpdated 2w ago
Repository

About setting-up-looker-project

A skill for creating a Looker project and configuring it with a local bare Git repository. It guides Looker developers through project creation and setup verification using Looker CLI.

Key features

  1. 01Create a Looker project
  2. 02Configure a local bare Git repository
  3. 03Verify Git configuration

Use cases

  1. 01Start a Looker project without external Git hosting
  2. 02Check that a project's Git settings are active

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/looker-open-source/looker-skills --skill setting-up-looker-project

After installing, type/setting-up-looker-projectin Claude Code to confirm it loaded.

Details

From the project README

Setting Up Looker Project

Creates a new Looker project and configures it with a local bare Git repository.

Prerequisites

  • Looker CLI must be installed and authenticated (see installing-looker-cli and authenticating-looker-cli skills).

Instructions

1. Switch to the Development Workspace

Switch to the 'dev' workspace (required for creating or modifying project configurations). It is recommended to chain this with project operations to guarantee dev workspace persistence:

looker-cli session update dev
2. Create the Project

Write the project name payload to /tmp/project_create.json:

{
  "name": "{project_id}"
}

Create the Looker project using the project import command (chained with session update dev):

looker-cli session update dev && looker-cli project import /tmp/project_create.json

Note

Use a unique, URL-safe name for {project_id} (e.g., my_new_project).

3. Configure Local Bare Git Repository

Write the Git configuration payload to /tmp/project_git.json:

{
  "git_service_name": "bare"
}

Configure the project to use a local bare Git repository:

looker-cli session update dev && looker-cli project update {project_id} /tmp/project_git.json

Note

This sets up a local Git repository on the Looker server, which is ideal for quick onboarding without needing external Git hosting.

4. Verify Project Setup

Retrieve the project details to verify that Git was correctly configured:

looker-cli project cat {project_id}

Ensure the output indicates that uses_git is true and git_remote_url is not null (it will look like ../../bare_models/{project_id}.git).

Note

There might be a slight propagation delay on the Looker server after updating Git. If the project cat command fails (e.g., with a 400 error), wait a few seconds and retry.

Comments

Markdown supported